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1. INTRODUCTION 


This report provides documentation for the User Interface Program for the Minimum 
Hamiltonian Ascent Trajectory Evaluation (MASTRE). The User Interface Program is a separate 
software package designed to ease the user input requirements when using the MASTRE Trajectory 
Program. This document supplements documentation on the MASTRE Program that consists of the 
MASTRE Engineering Manual and the MASTRE Programmers Guide. The User Interface Program 
provides a series of menus and tables using the VAX Screen Management Guideline (SMG) software. 
These menus and tables allow the user to modify the MASTRE Program input without the need for 
learning the various program dependent mnemonics. In addition, the User Interface Program allows 
the user to modify and/or review additional input Namelist and data files, to build and review 
command files, to formulate and calculate mass properties related data, and to have a plotting 
capability. 

This document has been prepared to provide the user a step-by-step tutorial for 
implementing the User Interface Program. Following the introduction, two sections are used for 
general discussions of the use of the MASTRE Trajectory Program and the User Interface Program. 
Section 2 is a discussion of the terms, nomenclature, and general operating procedures used in the 
simulation of trajectory problems on the MASTRE Program. 

Section 3 is a discussion of the User Interface Program. The User Interface Program consists 
of 15 sections based on the divisions provided in the main menu of the program. These divisions are 
launch and initial conditions, thrust event related data, stage related data, propulsion data, 
aerodynamic data, attitude data, mass properties, environmental data, constants, operational options, 
optimization data, output options, dispersions, command file creation/modification, and plotting, and 
are discussed in Sections 4 through 18. Although the discussion will be provided in a sequential 
fashion, the user is not limited in the manner that he wishes to modify and/or review data while using 
the software. Section 19 describes the output produced by the MASTRE Program. 

Appendix A describes the use of the user interface portion of the Mass Properties Program. 
The Mass Properties Program is a separate program that can be used to calculate mass properties data 
(i.e., center of gravity (CG), propellant flowrate, and weight overboard) for a variety of motor types. 
These motor types include throttable and nonthrottable liquid engines, solid-rocket motors (SRMs), 
and hybrid motors. Using data from the Mass Properties Program, the MASTRE Program can 
calculate, in a dynamic fashion, the longitudinal, lateral, and normal components of the CG. The user 
has the option of either using the data from the Mass Properties Program or using tabular values of 
propellant weight versus longitudinal, lateral, and normal CG. 
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Appendix B describes the input and output requirements of the Root-Sum-Square (RSS) 
Program. This program was written as a post-processor to the MASTRE Program to provide dispersion 
analysis output. Output of the RSS Program is in the form of tabular output or files that can be used 
with graphic software programs (i.e., Cricket Graph) to provide plots of the user-defined data. 

Because of the use of the SMG routines, the User Interface Program is limited to use only on 
the VAX computer system or systems having these routines. Therefore, portability of this software to 
another computer system is limited and would require a major effort to place the User Interface 
Program on a computer system that does not have these routines. 

Due to their size, the MASTRE Program, the User Interface Program, and the Mass 
Properties Program have not been integrated into one program. The interface between these three 
programs is the input files generated for the MASTRE Program by the User Interface Program and the 
Mass Properties Program. 
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2. IMPLEMENTATION OF TRAJECTORY PROBLEMS ON THE 
MASTRE PROGRAM 

The implementation of a trajectory problem on the MASTRE Program necessitates that the 
user understands the basic input mechanics and be aware of the various options. Through proper 
option selection, the MASTRE Program can be used to simulate an assortment of trajectory problems 
varying from simple point mass trajectories to complex atmospheric moment balanced trajectories. 
This flexibility stresses the importance of understanding the available options. This section contains 
a discussion of the terms, nomenclature, general operating procedures, and options and explains the 
method of setting up a trajectory problem. 

2.1 THRUST EVENTS 

The trajectory profile is simulated and setup in the MASTRE Program as a succession of up 
to 15 thrust events, one or more of which describes a physical stage (there can be up to 5 stages). A 
thrust event is a period of time characterized by a continuous thrust profile (constant, zero, or varying 
in a continuous fashion). The declaration of a thrust event is based on a change in thrust and/or 
flowrate or the manner in which thrust and/or flowrate is derived, a change in attitude philosophy, an 
instantaneous weight drop (or jettison), a stage change, or at any time desired by the user. Each thrust 
event is initiated at the termination of the previous thrust event except, of course, for the first event 
that initiates the trajectory. 

A typical thrust event profile for a three-stage trajectory simulation is shown in Figure 2-1. 
In this example profile, the first stage consists of two thrust events, the second stage also has two 
thrust events, and the third stage has only one thrust event. This profile could exemplify the trajectory 
of a two-stage booster with a single upper stage. The times associated with the beginning (or ending) 
of the thrust events reflect major events in the trajectory simulation. A great deal of generality is 
gained by allowing many of the input values to be dependent on the thrust event index rather than 
time from lift-off since the duration times of the thrust events are used as optimization parameters and 
can change the time from lift-off history significantly. 

Input associated with the thrust event describes the parameter characteristics within the 
thrust event time period. However, since some data are applicable to more than one thrust event, a 
distinction is made between data associated with the entire trajectory, stage related data, and thrust 
event related data. Table 2-1 provides a breakdown of the input variables into these classifications. 
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Table 2-1. Data Groupings 


Entire Trajectory 

Stage Related 

Thrust Event Related 

Liftoff weight 

Aerodynamic coefficient tables 

Vacuum thrust level 

Flight azimuth 

Base force tables 

Propellant flowrate 

Launch longitude 

CG tables 

Acceleration limits 

Launch latitude 

Aerodynamic reference length 

Number and selection of engines 

Engine data 

Aerodynamic moment reference 

Throttle options (MPS) 

Wind tables 

Attitude angle tables 

Jettison weights 

Optimization parameter 
selection 

Attitude polynomial order 

Drop weights 

Terminal and intermediate 
constraint selection 

Number of thrust events per 
stage 

Time duration of event 

Initial state requirements (if 
jump start 

Engine control option 

Weight drop times 

LBM data 

SRB data 

Number of weight drops 

Initial time 

MPS constant throttle levels 

Integration stepsize (forward and 
backward) 

Integration constants 

AOA tables 

Print interval 

Output options 

Vertical rise termination time 

Aerodynamic reference area 

Attitude control options 

Roll maneuver initiation time 


Optimization scheme parameters 

Tilt-over maneuver termination 
time 


Earth model constants 

Branch trajectory parameters 
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2.2 ATTITUDE CONTROL OPTIONS 

One of the main purposes of the MASTRE Program is to define the optimum attitude of the 
space vehicle to maximize or minimize some payoff function while satisfying a variety of terminal and 
intermediate constraints. Optimization of the attitude is based on being able to express the partial 
derivatives of the equations of motion with respect to both the state variables and the attitude angles 
(in this case, the pitch and yaw angles). For some configurations like the Space Shuttle, the complexity 
of the booster stage nonlinear aerodynamic model prevents the application of the attitude optimization 
using the min-H strategy during the first stage. Therefore, additional attitude control options are 
available to use during portions of the trajectory when the min-H strategy cannot be used (of course, 
these options are not restricted to these portions and can be used whenever a particular attitude 
orientation is desired). The attitude profile after vertical rise for a vehicle that uses linear 
aerodynamics in the booster stage can be optimized using the min-H strategy. The following seven 
attitude control options are available: 

1. Attitude control based on Mach number-dependent tables of angle of attack (AOA) and 
sideslip angle; 

2. Attitude control based on time dependent nth-order polynomial equations; 

3. Attitude control based an alternate coordinate system (the Boost Reference Coordinate 
System) used by the Space Shuttle prime contractor; pitch and yaw angles are a function 
of Earth-fixed velocity, and the roll angle is a function of time from lift-off; 

4. Attitude control based on Earth -fixed, velocity-dependent tables of pitch and yaw angles; 

5. Attitude control based on time-dependent tables of pitch and yaw angles; 

6. Attitude control based on maintaining a given value of the product of dynamic pressure 
and AOA (Q-alpha); and 

7. Attitude control based on the min-H technique. 

In all but Option 3, the roll angle is assumed to be in either a fixed heads-up or heads-down 
orientation. 

Using Option 2, a quasi optimum attitude profile can be attained for either a portion or all of 
the booster trajectory (excluding the lift-off, or vertical rise, phase). Optimization requires the 
parametric variation of the angles used in the definition of the polynomial expression(s). Use of the 
other methods precludes optimization of the attitude history. Multiple options can be used within a 
given stage. For example, the polynomial attitude control can be used to simulate a tilt-over maneuver 
that can be followed by an attitude control based on AOA and sideslip angle. The implementation of 
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these options is further explained in Section 9. The following subsections describe the use of these 
options. 

2.2.1 AOA/Sideslip Angle Control 

AOA/sideslip angle control requires that the booster trajectory be subdivided into a 
minimum of three attitude phases: 

1. A vertical rise phase where attitude is determined referenced to the Earth model; 

2. A tilt-over maneuver consisting of attitude polynomials (in most cases a linear pitch 
function only) that are used to force the relative velocity into the desired flight plane-the 
amount of tilt-over angle required can be optimized by the variation of the angles used 
to define the polynomial(s); and 

3. Continuation of the booster simulation based on the AOA/ sideslip angle history. 

The first phase requires the input of the vertical rise termination time and requires no 
additional input. The second phase begins at the end of the vertical rise maneuver and ends at tilt- 
over termination time. Other inputs for this phase are described in Subsection 2.3. The third phase 
begins at the termination of the tilt-over maneuver and terminates at booster separation (the end of 
the stage). During this phase, AOA, sideslip angle, and Mach number tables are interpolated using 
input table values (see Section 8 for more details on the input requirements). 

2.2.2 Attitude Polynomial Control 

Two sets of attitude polynomials of the form: 

c = a 0 + a i t + a 2 t 2 + ••• + a n t n (2-1) 

are available for a variety of uses. As discussed in the previous subsection, the tilt-over maneuver 
(phase 2) uses a polynomial expression, in most cases linear, to describe the attitude history during 
this maneuver. Input requirements for this maneuver are the tilt-over termination time, the order of 
the pitch and yaw polynomial expressions, values of pitch and yaw attitude angles that define the 
initial guess for the polynomial expressions, and table values of incremental time from the beginning 
of the tilt-over maneuver. Continuity of the attitude angles between the vertical rise maneuver and 
the tilt-over maneuver is maintained by internally setting the first values of the pitch and yaw attitude 
tables to the pitch and yaw values at the end of the vertical rise maneuver. 

Optimization of the tilt-over maneuver polynomial expressions (except for the first values of 
the pitch and yaw tables) can be accomplished by setting the corresponding values of the parameter 
optimization indicator (see Section 13). For user convenience, the method of parameterizing the 
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attitude angles in the construction of the polynomial expressions is used rather than the polynomial 
coefficients. 

2J 2 3 Attitude Control Using the Booster Reference Coordinate System 

Attitude control using the Booster Reference Coordinate System implies that pitch, yaw, and 
roll angles will be provided from lift-off to booster separation. The pitch and yaw angles (theta and phi) 
are input as tabular functions of Earth-fixed velocity, and the roll angle (sigma) is input as a tabular 
function of time from lift-off. When using this option, neither the vertical rise maneuver nor the tilt- 
over maneuver are required. Also, no optimization parameters are available when using this option. 

2.2.4 Attitude Control Using Pitch and Yaw Tables 

This attitude control option has been placed in the program to allow the user to replicate the 
predefined booster attitude angles when performing a dispersion run. Using this option, the user can 
select the independent table for these angles as either time from lift-off or Earth-fixed velocity. Similar 
to the Booster Reference attitude option, the vertical rise and tilt-over maneuvers are not used for this 
option and, similarly, no optimization parameters are available when using this option. 

2.2.5 Attitude Control Based on a Constant Value of Q-Alpha 

This attitude control option has been included in the program to allow the user to maintain 
a given value of the product of dynamic pressure and AOA (or Q-alpha). If the program is allowed to 
optimize the booster attitude profile, via min-H, it has been shown that the value of Q-alpha exceeds 
the design limits throughout most of the booster trajectory. By allowing the program to define the 
attitude based on the required limit of Q-alpha, a constrained trajectory can be determined. Using this 
option is similar to the AOA option since the vertical rise and tilt-over maneuvers are required. The 
time of termination of the tilt-over maneuver should correspond to the time the Q-alpha approaches 
the constrained value (this time can be obtained by using the min-H strategy to optimize the booster 
trajectory). The termination of the Q-alpha can be accomplished by creating a thrust event that occurs 
when the Q-alpha on the optimum trajectory is less than the absolute value of the Q-alpha constraint 
value. At this thrust event, the min-H strategy may be initiated. 

2.2.6 Attitude Control Using the Min-H Optimization Technique 

The min-H optimization technique can be used to define the vehicle attitude any time 
following the vertical rise maneuver. However, as discussed earlier, the min-H technique can only be 
used when linear aerodynamics are used in the first stage. Otherwise, the min-H technique can be 
initiated at the beginning of the second stage (i.e., because of the nonlinear aerodynamics used in the 
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Space Shuttle simulation, the min-H technique can only be initiated after SRM separation). Initiation 
of this option is denoted by specifying the thrust event index that the min-H will begin. The attitude 
history during the min-H portion of the trajectory can be divided into seven independent phases of 
which phase is specified by an initiation and terminal thrust event index, the number of table points 
in each phase, and the tabular values of time and attitude angles. For each phase, the user can also 
select either in-plane (pitch plane only) or pitch and yaw control. The number of points in each attitude 
angle versus time table for each phase cannot exceed 29 points and must be an odd number of points 
(>1) due to the use of Simpson's Rule in the evaluation of the backward trajectory. 

Although the user may require up to 29 points for a given segment, all 29 points in the 
attitude angle table array are not required as input. The reason is that the program, by linear 
interpolation, initially determines the attitude angles at discrete points on the trajectory regardless of 
the number of points input. After the initial iteration, however, the optimization algorithm continually 
alters both the independent and dependent tables and stores the required number of updated 
variables. 

2.2.7 Post-Launch Roll Maneuver 

When simulating the Space Shuttle, all of the attitude options, except for the Booster 
Reference option, can use a roll maneuver that simulates the post launch rotation of the vehicle so that 
the Orbiter tail fin is in the flight plane. This maneuver begins at the roll maneuver input time and 
ends at a time defined by dividing the angular requirement (the difference between the initial 
placement of the tail fin and the final placement based on a heads-up or heads-down orientation) and 
the input roll rate. If this maneuver is not required, the value of the roll rate should be set to zero. 

2-3 INPUT REQUIREMENTS FOR THE EQUATIONS OF MOTION 

Input for the MASTRE equations of motion require the user to provide aerodynamic, thrust, 
environment, and gravitational and Earth modeling data. The following subsections provide an 
overview of the input requirements for these models. 

2.3.1 Aerodynamic Model Input 

The modeling of the aerodynamic forces consists of two distinct models.* nonlinear and linear. 
The nonlinear model is used for the Space Shuttle and consists of a series of equations that define the 
force and moment coefficients as a function of Mach number, AOA, sideslip angle, and inboard and 
outboard elevon deflection angles. The coefficients of these equations are expressed in a tabular 
fashion. Because of the large amount of data, the MASTRE Program uses an automated aerodynamic 
data base for the majority of the aerodynamic input data. This feature minimizes data handling by the 
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user and allows access to the latest aerodynamic data (which is maintained by the MSFC Aerodynamic 
Section). The capability to modify the nonlinear aerodynamic data has not been included in the User 
Interface Software since this data base is maintained externally. 

The user can select to use either nonlinear and linear aerodynamic models or the linear 
model alone. Inputting the linear models requires providing tables of Mach number dependent values 
of constants and slope for the force and moment coefficients. Additionally, values of aerodynamic 
reference area, reference lengths, and axial and normal moment reference points are input as a 
function of stage. 

The aerodynamic model also consists of base force data, elevon data, and hypersonic viscous 
interaction data. Base force data are input as altitude-dependent values of axial and normal force and 
pitching moment base force components. Separate tables of the base force data are available for the 
booster stage and the upper stages. Upper-stage data are also separated into engine-out and nominal 
data. Booster stage data require an additional table of reference dynamic pressure. AOA and sideslip 
angle dependent base force data, used for the Space Shuttle, are also available. 

Elevon data, used for Space Shuttle simulations, are based on relative velocity and Mach 
number dependent tables of in-board and out-board deflection angles. Used in the nonlinear 
aerodynamics equations, the aerodynamic coefficients are based on the difference between the relative 
velocity dependent in-board and out-board deflection schedule and a Mach number dependent in-board 
and out-board deflection table. 

Hypersonic viscous interaction data are based on the user providing tables of Mach number 
dependent constants, slopes, and accelerations (with respect to AOA) data for continuum flow and 
molecular flow of axial and normal force coefficients and pitching moment coefficients. 

All of the above data, except for the nonlinear aerodynamic data, can be modified by using 
the User Interface Software. 

2.3.2 Thrust Model Input 

Six propulsion systems can be simulated in the MASTRE program. These systems are 
consistent with current or future NASA propulsion systems. Current systems are the Main Propulsion 
System (MPS), the SRM, the Orbital Maneuver System (OMS), and the Rocket Control System (RCS). 
The fifth system, the Liquid Booster Module (LBM), is available as a future liquid propulsion system. 
A sixth system, a fixed Main Propulsion System, is also available if the user wishes to simulate MPS 
engines that are not considered to be used in vehicle control (i.e., fixing an opposing engine in an 
engine-out situation). 
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An attempt has been made in the programming of these propulsion systems to generalize the 
input requirements, but, because of the uniqueness of each system, a totally general input was not 
practical. However, several input arrays do define, in a general nature, certain information concerning 
all propulsion systems. These arrays are denoted in the General Propulsion menu (see Section 6) as 
individual engine data, propellant per system, thrust event allocation per system, and thrust event 
allocation per engine. The individual engine data are defined by the following parameters: 

1. Engine type ( 1-MPS, 2-SRM, 3-LBM, 4-OMS, 5-RCS, or 6-Fixed MPS); 

2. Longitudinal location of engine i; 

3. Vertical location of engine i; 

4. Pitch cant angle of engine i; 

5. Yaw cant angle of engine i; 

6. Vacuum thrust of engine i at 100% power level; 

7. Propellant flowrate of engine i at 100% power level; and 

8. Nozzle exit area of engine i. 

Propellant per system data provide the total amount of propellant weight per propulsion 
system. Propellant weight is used in several ways. Excess propellant is calculated in the weight 
summary tables based on differences between the total propellant weight and the amount of used 
propellants. Having individual weight arrays for each propulsion system allows for the integration 
and printout of the separate propellant weight time histories of each system. The propellant weight is 
also used when the user desires to terminate a stage on utilization of all consumable propellant. 

Thrust event allocation per system data provide the number of system types to be used for 
each thrust event. Thrust event allocation per engine data specify the particular engine, based on the 
individual engine data index, that will be used for each thrust event. 

Unique data for all propulsion systems are denoted in the User Interface Program by 
separate sets of data for each propulsion system. MPS data are subdivided into thrust event related 
data, throttle data, minimum throttle data, thrust tailoff data, and specific impulse data. Thrust event 
related data define the thrust option to be used during each thrust event. Six options are available: 

1) normal operations, constant thrust and no throttling required; 2) throttle table used; 3) throttle 
table used but table is modified to achieve maximum dynamic pressure; 4) use variable throttle to 
maintain acceleration limit if limit is reached; 5) use constant throttle if acceleration limit is reached; 
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and 6) thrust tailoff. Throttle data, minimum throttle data, thrust tailoff data, and specific impulse 
data are input by time-dependent tables. 

SRM, LBM, OMS, and RCS data are input by time dependent tables, which include thrust, 
flowrate, and, for the SRM, exit area. 

2.3.3 Environment Model Input 

Environmental modeling is based on a variety of atmospheric and wind models. Atmospheric 
models consist of a month dependent range reference model; the Patrick hot, cold, and reference 
models; and the Vandenburg hot, cold, and reference models. Wind models consist of mean annual 
winds, annual enveloping winds, monthly winds for both Eastern and Western Test Ranges, and wind 
tables provided by the user. 

2.3.4 Gravitational and Earth Model Input 

All gravitational and Earth model input is preset within the program. Gravitational and 
Earth model data are provided in the User Interface Program but are "read only" and, therefore, cannot 
be changed. 

2.4 INTEGRATION SCHEME 

The MASTRE Program can use one of three integration methods. These methods are an 
Adams-Moulton fourth-order scheme, which has the ability to select its own stepsize, a Runge-Kutta 
fixed step method, and a fixed step Adams-Moulton method. Different methods can be used for the 
forward and backward integration. Initial and fixed step sizes for forward and backward are input as 
a function of thrust event. 

2.5 OPTIMIZATION METHODOLOGY 

The flow logic of the MASTRE Program assumes that every problem simulated will 
determine the maximum, or minimum, of some payoff function subject to a set of terminal and 
intermediate constraints. Optimization is performed by the optimization of the attitude angles during 
the min-H phase and the optimization of certain trajectory parameters. The user can select a variety 
of constraints and parameters by proper input selection using the menus of the User Interface 
Program. 

2.5.1 Selection of the Payoff Function and the Terminal and Intermediate Constraints 

A large library of parameters can be used either as the payoff function, terminal constraints, 
or intermediate constraints (see Table 2-2). Menus (see Section 11) are used to allow the user to 


2-9 



specify which parameters, based on the library code index in Table 2-2, will be used as well as the 
constrained values. 


Table 2-2. Payoff and Constraint Library 


Library 

Number 

Symbol 

Function Name 

Units 

1 

m f 

Cutoff weight 

lb 

2 

Vi 

Inertial velocity 

m/s 

3 

Yi 

Inertial flight path angle 

deg 

4 

R 

Radius 

m 

5 

h 

Altitude above ellipsoid model 

m 

6 


Not used 

- 

7 

v e 

Earth referenced velocity 

m/s 

8 

^ze 

Earth relative heading angle 

deg 

9 

Ye 

Earth fixed flight path angle 

deg 

10 

i 

Inclination angle 

deg 

11 

®n 

Inertial descending node from launch 

deg 

12 

- 

Not used 

- 

13 

- 

Not used 

- 

14 

AV 

Orbital velocity including oblate effects (see 
Reference 7) 

m/s 

15 

Qmax 

Maximum dynamic pressure 

lb/ft 2 

16 

H 

Stagnation heating indicator 

BTU 

17 

AV*,, 

Relative velocity increment from linear 
relationship between relative velocity and range 
(RTLS terminal condition) 

m/s 

18 

AV a 

Velocity increment from linear relationship 
between ET propellant AV available and range 
(RTLS initiation condition) 

m/s 

19 

Rng 

Range from the launch site 

nm 


2.5.2 Selection of the Control Parameters 

In addition to the min-H optimization of the attitude control, several trajectory parameters 
can be optimized using the steepest ascent algorithm. The specification of these parameters is input 
by using the menu defined in Section 12. Table 2-3 shows the parameters that are available to be 
optimized. 
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Table 2-3. Parameter Library 


Library 

Number 

Parameter Name 

Symbol 

1 to 15 

Bum time for i th thrust event 


16 

Lift-off weight 

Wu, 

17 

Launch azimuth 

A*l 

18 to 24 

Booster pitch attitude angles 

X P 

25 to 28 

Booster yaw attitude angles 

Xy 

29 

Time to start MPS throttle ramp 

t. 

30 

Time after maximum dynamic pressure 


31 

Value of throttle at bottom of ramp 

f 

32 to 34 

Values of sideslip angle history 

Pi 


2.6 SIMULATION OPTIONS 

The following subsections discuss several simulation options available to the user. 

2.6.1 Jump-Start Option 

Reinitialization of the trajectory at a given time is handled differently depending on whether 
the "jump-start" time occurs during the first stage or during an upper stage. 

The first-stage jump-start option operates by specifying jump-start times as input in a 
nominal trajectory. As additional input, an output file is requested by name if the first value of the 
jump-start time variables (see Subsection 13.5.2) has a non-zero value. If the demand mode is active, 
the user is prompted to define the file name; otherwise, the file is specified in the command file after 
the name of the Namelist file (see Section 17). During the converged trajectory, the state and other 
related parameters associated with the jump-start times are written to the named output file. The only 
constraint is that these jump-start times must occur within the first thrust event. 

To run the jump-start trajectory, the output file generated in the above process is specified 
by the user in the same manner in either a demand or nondemand mode. The initial lift-off time 
parameter (see Section 4) specifies the time to begin the jump-start trajectory by comparing this time 
with the time parameters on the specified input file. 

Reinitialization of an upper stage trajectory is designated by denoting, in the input, the 
thrust event where the jump-start will occur. Nominally, the assumption is that the trajectory will be 
initialized on the ground. In this case, the normal ground-to-insertion logic will be maintained. A 
ground-to-insertion trajectory requires the user to input the geodetic latitude, the longitude, and the 
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altitude of the launch site and the flight, or launch, azimuth. To initialize the upper-stage jump-start 
option, the user must supply the state parameters at the jump-start time, which is an array of 25 
variables. 

2.6.2 Branch Trajectory Option 

The branch trajectory option allows the user to simulate both the nominal and engine-out 
trajectories within the same run. This capability allows the user to design the trajectory of the first 
stage based on meeting the terminal and intermediate constraints of both the nominal and engine-out 
trajectories. Input variables are used to save the branching point of the trajectory and indicate where 
the next portion of the trajectory begins. 

The branch trajectory is setup in the same manner as other trajectories using thrust events 
and thrust event related data. The primary difference is that the trajectoiy is divided into stages, and 
the stages after the booster stage can be treated as separate trajectories. The terminal constraints are 
placed on the final stage, and the user must impose intermediate constraints on the remaining stages. 
Additional intermediate constraints can be handled in the same manner. Optimization is based on 
maximization of the sum of the final masses of the branching trajectories. Although time on the output 
is based on time from lift-off, the actual time within the simulation is a continuous function and 
consists of the summation of thrust event times. 

For example, if an engine-out/nominal trajectory is being simulated, the trajectory should be 
divided into at least three stages: the booster phase, the engine-out phase, and the nominal phase. The 
user must provide the thrust event index, which begins the second stage, and a stage-dependent index, 
which indicates that the set of state variables stored will be used to initialize the third stage. If the 
second stage has two thrust events, for example 4 and 5, then the end point constraints will be 
considered intermediate constraints and will occur at thrust event number 5. The end conditions for 
the engine-out trajectory will be used to define the values of the intermediate constraints. These 
constraints are combined with the terminal constraints at the end of the nominal trajectory and any 
other intermediate constraints to define the total trajectoiy constraints. The user is limited to a 
maximum of 1 payoff function and 19 constraints (terminal plus intermediate). Another stage- 
dependent variable defines when the backward trajectory uses all data or partial data for attitude 
optimization. The value of this variable defines which set of intermediate constraint values are used 
with respect to the branch portion or, in this case, the second stage of the trajectory. For example, the 
attitude during the second stage will not be a function of the third stage optimization, but the first 
stage attitude optimization is a function of both second and third stages. Therefore, for this case, this 
variable will be equal to zero for the first stage, one for the second stage (since it relates to the first set 
of intermediate constraints), and zero for the third stage. 
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2.6.3 Dispersion Option 

The MASTRE code generates an output file for dispersion analysis. This output file is 
utilized by a separate program (the RSS Program), which calculates the root-sum-square (rss) of 
various dispersions with respect to several nominal trajectory variables and displays the dispersion 
data via output tables and/or plot files (which can be used by graphical software). The specific 
parameters are shown in Table 2-4. Input parameters discussed in Section 16 are needed to exercise 
the dispersion option. 


Table 2-4. MASTRE Output Variables for Dispersion Analysis 


1 . 

Time from lift-off (s) 

14. 

Inertial azimuth (deg) 

2. 

Axial acceleration (g's) 

15. 

Geodetic latitude (deg) 

3. 

Altitude (ft) 

16. 

Longitude (deg) 

4. 

Radius (ft) 

17. 

Impact latitude (deg) 

5. 

Relative velocity (ft/s) 

18. 

Impact longitude (deg) 

6. 

Inertial velocity (ft/s) 

19. 

Vehicle weight (lb) 

7. 

Dynamic pressure (psf) 

20. 

AOA (deg) 

8. 

Relative flight path angle (deg) 

21. 

Sideslip angle (deg) 

9. 

Inertial flight path angle (deg) 

22. 

Pitch attitude command (deg) 

10. 

Stagnation heating (BTU) 

23. 

Yaw attitude command (deg) 

11. 

Stagnation heating rate (BTU/s) 

24. 

Liquid propellant consumed (lb) 

12. 

Down range (ft) 

25. 

Solid propellant consumed (lb) 

13. 

Cross range (ft) 




If the trajectory is declared to be a dispersion run, the user is also asked to identify the name 
of the dispersion output file in the command file. The first time this dispersion file is used by MASTRE, 
the user must initialize the file by selecting the menu item in the Dispersions submenu (see 
Section 16). Table 2-5 shows the types of dispersion runs that the RSS software has been setup to 
output. The IVAR parameter is an internal index used to identify the types of dispersion runs. This 
parameter is defined in the User Interface Software from the user's input selections. Every trajectory 
is allowed a maximum of 300 points; therefore, the user must be careful in the selection of the input 
variables. 
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Table 2-5. Dispersion Types 


| Starting address for IVAR direct access storage file 




Value 

Dispersion Type 

Positive 

Negative 


0010 

Nominal 

00001 


Propulsion 

101_* 

SSME vacuum thrust 

00301 

00601 


102_ 

SSME vacuum Isp 

00901 

01201 


103_ 

SSME mixture ratio 

01501 

01801 


104_ 

SSME thrust misalign (pitch) 

02101 

02401 


105_ 

SSME thrust misalign (yaw) 

02701 

03001 


106_ 

ASRM web action time 

03301 

03601 


107_ 

ASRM vacuum Isp 

03901 

04201 


108_ 

ASRM propellant loading 

04501 

04801 


109_ 

ASRM inert weight 

05101 

05401 


U0_ 

ASRM thrust misalign (pitch) 

05701 

06001 


Hl_ 

ASRM thrust misalign (yaw) 

06301 

06601 


11 2_ 

ASRM thrust imbalance 

06901 

07201 


11 3_ 

ASRM thrust uncertainty 

07501 

07801 

Aercv'Envir 

201. 

Forebody axial force 

08101 

08401 


202_ 

Base force 

08701 

09001 


203_ 

Other Aerodynamic coeff 

09301 

09601 


204_ 

Wind profiles (head and tail) 

09901 

10201 


205_ 

Wind profiles (rt and It cross) 

10501 

10801 


206_ 

Atmospheric density 

11101 

11401 

Mass Prop 

301_ 

Core inert weights 

11701 

12001 


302_ 

Propulsion mod inert wt 

12301 

12601 


303_ 

Core propellant weight 

12901 

13201 


304_ 

Center of gravity 

13501 

13801 

GN&C 

401_ 

Booster pitch steering program 

14101 

14401 


402_ 

Booster yaw steering program 

14701 

15001 

Composite 

5010 

Composite (max dyn pres) 

15301 



5020 

Composite (min dyn pres) 

15601 



5030 

Composite (max aero heating) 

15901 



5040 

Composite (min aero heating) 

16201 



5050 

Composite (max altitude) 

16501 



5060 

Composite (min altitude) 

16801 



5100 

RSS data 

18001 


* 0 - positive dispersion, 1 - negative dispersion 
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The RSS Program accumulates the dispersions generated by the MASTRE Program, which 
are placed on the dispersion file, and calculates a composite RSS of the system and environmental 
dispersions. By using these RSSed values, the user can then generate composite trajectories that 
emulate the effects of combinations of the positive and negative dispersions. The composite 
trajectories generated by the user are placed in the dispersion file and are also displayed in both the 
output tables and the plot files. 

Input to the RSS Program requires the user to provide the names of the dispersion file 
generated by the MASTRE Program and the output table and plot files that will be generated by the 
RSS Program. Additionally, the program will ask the user to define the variables that will be used to 
generate the RSS Program output. 

Outputs of the RSS Program are an output table file and two plot files. The output tables 
contain publishable tables that show time ordered nominal trajectory parameters, the variations from 
the nominal caused by various effects, and the calculated plus and minus rss values. Two plot files are 
provided to allow the user to either plot many trajectory parameters on the same file or plot one 
parameter and various dispersion trajectories on the same file. The first plot file can include all of the 
parameters from Table 2-4 and contains the nominal values, the nominal plus and minus the RSSed 
values, and the plus and minus composite trajectories. The second plot file allows one parameter from 
Table 2-4 and contains the nominal trajectory values; the plus and minus composite trajectory values; 
and all, or selected, trajectory values based on the dispersions (see Table 2-5). The plot files must be 
transported to the Macintosh from the VAX such that a graphic software package, like Cricket Graph, 
can be used to generate plots. 

2.6.4 Output Files 

Three output files, FOR031.DAT, FOR021.DAT, and FOR007.DAT, are generated whenever 
a trajectory simulation is run. The FOR031.DAT file provides the general trajectory data consisting of 
printouts of the input Namelists, the iteration associated data, and block prints of time and various 
parameters. These outputs will be discussed in Section 19. 

The FOR021.DAT file consists of the outputs generated by the weight summary tables, the 
gains summary tables, and the optional parameter tables. The FOR007.DAT file is an optional output 
file and provides a time history of propulsion related data. The elements of the FOR021.DAT and 
FOR007.DAT output files are discussed in the following subsections. 
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2.6.4.1 Weight Summary Output 

The weight summary table and the gains summary table are system and mission dependent. 
Three weight summary tables are available that reflect anomalies of the three current types of vehicles 
that are modeled with the simulation. Tables 2-6 through 2-8 provide the formats used to identify 
weights in the separate output tables. Data in bold type indicate that the weight values are calculated 
and are not included in the weight summary input tables. Input for these tables is described later in 
Subsection 15.1. 

The gains summary table is also system dependent and only provides information relevant 
to the system being simulated. An additional table is output to provide information for the branch 
trajectory option. Stage separation related data are provided on the gains summary table. Data 
provided are time, altitude, relative velocity, inertial velocity, relative flight path angle, inertial flight 
path angle, dynamic pressure, axial acceleration, Mach number, and vehicle mass before and after 
separation. 

2.6.4.2 Parameter Table Output 

The parameter table output option provides publishable output tables that provide time 
histories of many of the output parameters available on the block output format. The formats and the 
parameters of these tables can be modified by the User Interface Program. 

2.6.4.5 Propulsion Table Output 

An output height table for both the liquid oxygen (LOX) and liquid hydrogen (LH2) tanks are 
provided as optional propulsion table output on the FOR007.DAT file. Additional inputs for outputting 
this table are required and will be discussed in Subsection 15.3. This option also requires two 
additional input files, which are defined in the command (.COM) file (see Section 17). 

2.6.5 Command File Creation 

The command file allows the user to specify several options to the code during execution. The 
inputs required by the command (.COM) file are shown in Table 2-9. The User Interface Program has 
automated the process of creating or editing the command file, which is described in Section 17. The 
following discussion should clarify the records of the command file. 
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Table 2-6. Multistage Liquid Vehicle Weight Summary Output Table 




UPPER STAGE - JETTISON WEIGHT 

- INERT STRUCTURE 

- FLIGHT PERFORMANCE RESERVE 

- DELTA VELOCITY PROPELLANTCFPS) 

- EXCESS PROPELLANT (PROP LD) 

- FUEL BIAS 

WEIGHT AT ORBIT INSERTION 
UPPER STAGE • PROPELLANT BURNED 
WEIGHT AFTER 2ND STAGE SEPARATION 
PERFORMANCE MARGIN - PAYLOAD 

- OTHER 

2ND STAGE ■ JETTISON WEIGHT 

- STAGE INERT WEIGHT (LESS ENG) 

- NONPROPULSIVE CONSUMABLES 

- DRY WEIGHT OF ENGINE(S) 

2ND STAGE - TOTAL WEIGHT AT 2ND STAGE SEP 

- PROP RESIDUALS/UNUSABLES 

- FLIGHT PERFORMANCE RESERVE 

- FUEL BIAS 

- MPS THRUST BUILDUP 

- BOILOFF, OVERFILL, DRAWBACK 
EXCESS MPS PROPELLANT (MPS PROP LOADED) 

SHROUD WEIGHT SEPARATED AT MECO 
INJECTED WEIGHT AT MECO 

SHROUD JETTISON WEIGHT 

PROPELLANT BURNED - SEPARATION TO MECO 

WEIGHT AT SEPARATION 

1ST STAGE - JETTISON WEIGHT 

- STAGE INERT WEIGHT (LESS ENG) 

- DRY WEIGHT OF ENGINE(S) 

- NONPROPULSIVE CONSUMABLES 

- FUEL BIAS 

- PROP RESIDUALS/UNUSABLES 
PROPELLANT BURNED - LIFTOFF TO SEPARATION 
LIFTOFF (T/W=1.0) 

MPS PROPELLANT 
IGNITION COMMAND (T-0) 

1ST STAGE - MPS THRUST BUILDUP 

- BOILOFF, OVERFILL, DRAWBACK 
PRELAUNCH WEIGHT (T-5 MIN) 

^Parameters in bold letters are internally calculated based on the trajectory output, all others are 
supplied through the input array. 



Table 2-7. Multistage Strap-On Vehicle Weight Summary Output Table 


UPPER STAGE - JETTISON WEIGHT 

- INERT STRUCTURE 

- FLIGHT PERFORMANCE RESERVE 

- DELTA VELOCITY PROPELLANT 

- EXCESS PROPELLANT (PROP LD) 

- FUEL BIAS 

- PROP RESIDUAL/UNUSABLE 

WEIGHT AT ORBIT INSERTION 

UPPER STAGE - PROPELLANT BURNED 
WEIGHT AFTER 2ND STAGE SEPARATION 
PERFORMANCE MARGIN - PAYLOAD 

- OTHER 

2ND STAGE- JETTISON WEIGHT 

- STAGE INERT WEIGHT (LESS ENG) 

- NONPROPULSIVE CONSUMABLES 

- DRY WEIGHT OF ENGINE(S) 

2ND STAGE-TOTAL WEIGHT AT 2ND STAGE SEP 

- PROP RESIDUALS/UNUSABLES 

- FLIGHT PERFORMANCE RESERVE 

- FUEL BIAS 

- MPS THRUST BUILDUP 

- BOILOFF, OVERFILL, DRAINBACK 

EXCESS MPS PROPELLANT (MPS PROP LOADED) 

SHROUD WEIGHT SEPARATED AT MECO 

INJECTED WEIGHT AT MECO 

SHROUD JETTISON WEIGHT 

PROPELLANT BURNED - SEPARATION TO MECO 

WEIGHT AT SEPARATION 

1ST STAGE - JETTISON WEIGHT 

- STAGE INERT WEIGHT (LESS ENG) 

- DRY WEIGHT OF ENGINE(S) 

- NONPROPULSIVE CONSUMABLES 

- FUEL BIAS 

- PROP RESIDUALS/UNUSABLES 

STRAP-ON - JETTISON WEIGHT 

- INERT MOTOR WEIGHT (LESS ENG) 

- DRY WEIGHT OF ENGINE(S) 

- NONPROPULSIVE CONSUMABLES 

- FUEL BIAS 

- PROP RESIDUALS/UNUSABLES 

- INERTS CONSUMED (SRM ONLY) 

PROPELLANT BURNED - LIFT-OFF TO SEPARATION 

MPS 

SRM 

LIFTOFF (T/W-1.0) 

MPS PROPELLANTS 
STRAP-ON PROPELLANT 
IGNITION COMMAND (T-0) WEIGHT 
MPS - THRUST BUILDUP 

- BOILOFF, OVERFILL, DRAINBACK 

PRE LAUNCH WEIGHT (T-5 MIN) 

♦Parameters in bold letters are internally calculated based on the trajectory output, all others are supplied 
through the input array. 
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Table 2-8. Space Shuttle Weight Summary Output Table 

*AYLOAD * ' 

OMSKIT 
MISSION KIT 

ORBITER - EMPTY 

- NONPROPULSIVE CONSUMABLES 

- USABLE RCS (RCS LOADED) 

- RCS RESERVES 

- RCS RESIDUALS 

- USABLE OMS (OMS LOADED) 

- OMS PROPELLANT (DEORBIT) 

- OMS RESERVES 

- OMS RESIDUALS 

SSME EMPTY 

ORBITER AT ORBIT INSERTION 

MECO OMS MANEUVER- OMS PROPELLANT 

- RCS PROPELLANT 
TRAPPED MPS PROPELLAN- ORBITER 

- SSME 

FLIGHT PERFORMANCE RESERVE- ORBITER 

- SSME 

ORBITER AT OMS IGNITION 
RCS PROPELLANT- ET SEPARATION 
EXTERNAL TANK - EMPTY 

- RESIDUALS 

FLIGHT PERFORMANCE RESERVE - ET 
FUEL BIAS 

EXCESS MPS PROPELLANT (MPS PROP LOADED) 

EXPELLED MPS PROPELLANT 

INJECTED WEIGHT AT MECO 

PROPELLANT BURNED - AOA/RTLS TO MECO 

TOTAL VEHICLE WEIGHT AFTER SRM SEPARATION- MPS 

- OMS 

- RCS 

OMS PROPELLANT DUMPED (RCS BURN) 

EXPELLED MPS PROPELLANT 
WEIGHT AT AOA/RTLS 

MPS PROPELLANT BURNED • LBM SEPARATION ** TO RTLS/AOA 
WEIGHT AT LBM SEPARATION 
LBM INERT WEIGHT 

PROPELLANT BURNED - SRM SEPARATION TO - LBM SEPARATION 

- MPS 

- LBM 

ET+ORBITER AFTER SRM SEPARATION 
SRM INERT WEIGHT 

SRM RESIDUAL PROPELLANT 
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Table 2-8. Space Shuttle Weight Summary Output Table (Concluded) 

lWJ-lkTs CONSUMED 

PROPELLANT BURNED - LEM IGNITION TO SRM SEPARATION- MPS 

- LBM 

- SRM 

LBM IGNITION (T+5 SEC) 

PROPELLANT BURNED - LIFTOFF TO LBM IGNITION- MPS 

- SRM 

LIFTOFF (T/W=1.0) 

SRB PROPELLANTS 

SRB INERTS 

MPS PROP ELLA NT 

SRB IGNITION COMMAND (T-0) 

MPS THRUST BUILDUP + SRM IGNITION DELAY 
OVERFILL, DRAINBACK, AND BOILOFF 
NON PROPULSIVE CONSUMABLES 
PRE LAUNCH WEIGHT (T-5 MIN) 

Parameters in bold letters are internally calculated based on the trajectory output; all others are 
supplied through the input array. 

**LBM data are only printed when the LBM is being simulated 

The records that begin "$WRITE SYS$OUTPUT" are used by the VAX system as optional 
title identification and are treated as nonexecutable instructions. Text is placed within quotes (" ") at 
the end of this declaration. The number of these lines is optional to the user. When creating a 
command, the User Interface Program defines one comment line as a title. If the user desires more of 
these lines, an edit feature is available to include additional comment lines. The comment lines are 
terminated by the "$RUN" request record. This record defines the version and location of the MASTRE 
Program that will be used in the simulation. 

After the "$RUN" record, the next record indicates the answer to the question "Do you want 
a print file? . This print file is the FOR031.DAT file that contains the trajectory run output. 

The next line indicates the answer to a question "Are you at a graphics terminal?". The 
user should always place a "YES" answer. The next line relates to this question since the user is asked 
to choose between a batch operation (=1) or a demand (=2) mode. The next line (as well as other lines 
at the end of the command file) is the answer to a menu of options that the user can select. These 
options are: O-terminate, 1-execute, 2-select Namelist data input, 3-write file for plots and tables, and 
4-printout menu. By indicating a value of 2, the input variables will be read. In most cases, since the 
answers to the above requests very rarely change, the User Interface Program defaults to the values 
shown in Table 2-9. The records in Table 2-9 define input and output file names that are needed by 
the MASTRE Program during execution. 
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Table 2-9. Command (.COM) File Input Options 


COM File Record 


Description 


$ WRITE SYS$OUTPUT " " 

$ WRITE SYS$OUTPUT M TITLE OF RUN” 


$RUN [dir.subdir] MASTRE 
YES *or NO 
YES or NO 
1 or 2 

0,1,2, 3, or 4 

Namelist data input, 3-write file for 
YES or NO (yes or no)** 

(Aero data base file name) 

Aero Namelist file name 
Weight Namelist file name 
YES or NO (yes or no) 

(SRM data base file name) 

TVajectory Namelist file name 
(Alternate mass properties file name) 
YES or NO (yes or no) 

(Plot file name) 

(Dispersion file name) 

(First-stage jump-start file name) 
(LOX tank height file name) 

(LH2 tank height file name) 

0, 1, 2, 3, or 4 

0, 1, 2, 3, or 4 

0, 1, 2, or 3 


FOR031JDAT file, 2-print and and save 
FOR031.DAT file] 


[Do you want a print file ?] 

[Are you at a graphics terminal ?] 

[ 1- batch, 2-demand] 

[0-terminate, 1-execute, 2-select plots and tables, 
4-printout menu] 

[Will a nonlinear aero data base be input?] 

[Only input if YES (or yes) answer] 

[Aerodynamic Namelist file] 

[Weights Namelist] 

[Are SRMs to be simulated?] 

[Only input if YES (or yes) answer] 

[Trajectory Namelist] 

[Only input if alternate mass properties flag is on] 

[Is plot file to be generated?] 

[Only input if YES (or yes) answer] 

[Only input if "ivar" nonzero] 

[Only input if first-stage jump-start is requested] 

[Only input if propulsion output table requested] 

[Only input if propulsion output table requested] 

[0-terminate, 1-execute, 2-select Namelist data input, 
3-write file for plots and tables, 4-printout menu] 

[0-terminate, 1-execute, 2-select Namelist data input, 
3-write file for plots and tables, 4-printout menu] 

[0-do not print and delete output FOR031.DAT file, 
1-do not print but save delete FOR031.DAT file and, 
3-print 


*BOLD values are to used as defaults 
**( ) Optional input or based on input values 
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The next record answers the question "Will a nonlinear aero data base be input? '. The 
aero data base referred to is the nonlinear aerodynamic data base (direct access file) used by the Space 

Shuttle. If a "Y or y is present, the name of the data base is required on the next record of the .COM 

file. Otherwise, the next record is related to the next input. 

The next record asks the user to specify the name of the aerodynamic input Namelist file. 
This file contains nonlinear and linear aerodynamic coefficients and data associated with base force 
data. The Namelist name associated with this data is "$AEROIN". 

The next record asks the user to specify the weight Namelist file that provides the weight 
summary information for the weight summary tables and provides pertinent data for several of the 
program options. The Namelist name associated with this data is ”$WEIGHTS". 

The next record is again the answer to a question with a logical variable. The question is 
"Are SRMs to be simulated?". If a "Y” or "y" is present, the name of the SRM data base file is 
required on the next record of the .COM file. This file contains time-dependent tables of thrust, 
flowrate, and exit area data for the SRM. 

The next record contains the file name of the general Namelist file. The Namelist name 
associated with this data is "$INPUT". 

The next record is optional and defines the file name of the alternate mass properties input 
file. This file is obtained by running the Mass Properties User Interface Program (see Appendix A). 
To use this input file, the user must specify this choice in the input (see Section 10). 

The next record answers the question "Is a plot file to be generated?". If a "Y" or "y" is 
present, the name of the output plot file is required on the next record of the .COM file. The plot file 

outputs all of the trajectory block output parameters (see Section 19) from the converged, or final, 
trajectory. 

The next four records are only required if certain option flags are set in the input. All, part, 
or none of these lines can be input by the user. The first set is a single line that is only required if the 
dispersion option flag is not equal to zero. A nonzero value requires that the user specify the name of 
the dispersion data file, which will be used to store trajectory data. The second record is required if a 
first-stage jump-start is being implemented. Jump-start conditions are saved on an output file if the 
first-stage jump-start time variable is greater than zero, and the launch time is equal to zero. The 
jump-start is activated if the jump-start variable flag is equal to 1 and the launch time is greater than 
0.1 (the launch time value should correspond to one of the jump-start times on the input file). The 
name of the input or output file is provided by the user in this record of the .COM file if this option is 
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used. The third and fourth records specify the names of the LOX and LH2 tank height tables, 
respectively. These names are only required if the propulsion output table option is to be used. 

The next record again answers the menu described above. The value of 1 is used to begin 
execution of the program. The next record answers the same menu with a zero value, which indicates 
termination of the run. 

The last record indicates the users desire for the status of the output FOR031.DAT file. The 
options are shown in Table 2-9. Options 2 and 3 are not operational. 


2-23 

(Reverse Blank) 



3. USE OF USER INTERFACE PROGRAM 


This section provides a tutorial for implementing the User Interface Program and discusses 
the use of special options. 

The user begins the execution of the User Interface Program by the command "RUN UFI". 
This command initiates the program and the words "MASTRE USER INTERFACE” (see Figure 3-1) 
appear on the screen. To clear the screen, the user must press the Return Key. The next screen (see 
Figure 3-2) requests the user to select the directory and subdirectory where the Namelist file resides. 
The user has the choice of using the default directory/subdirectory or typing in the appropriate 
directory/subdirectory. After specifying the directory/subdirectory location, the computer searches and 
displays the available general input Namelist files as shown in Figure 3-3 (the assumption is that a 
general input Namelist file exists). The selection is made by moving the cursor, via the arrow keys, to 
the required file name and pressing the Return Key. After selection of the general input Namelist file 
the user must select the vehicle system to be simulated and the mission scenario. The selection is made 
from menus as illustrated in Figure 3-4. Currently, the vehicle systems available are a Multistage 
Liquid Vehicle, a Multistage Solid-Rocket Booster (SRB) Vehicle, or the Space Shuttle. Following the 
simulation options, the user is asked to define a header that will be use on each page of the printout. 
If the existing header is sufficient, the user can press the Return key and continue. 


MASTRE USER INTERFACE 

Figure 3-1 . Initial Interface Menu 


Select Directory 


Default Directory is [MASTRE.UFI] 

Enter directory or hit return for default 
==> 

Figure 3-2. Directory Request Menu 


After selection of the vehicle system, the mission scenario, and the header, the next screen 
provides the main menu (see Figure 3-5), which the user can select from any of the 17 items. If the 
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user wishes to exit the program at any time, the "Quit" selection should be made on the main menu. 
Once the "Quit" selection is made, the user is asked, if changes have been made and not saved, if a 
new MASTRE input file is to be created or the old file updated. If a new file is to be created, the user 
must supply a file name. The program is terminated either after supplying the file name, pressing the 
Return Key, or a negative answer to the question. 



Please wait, I am looking for .ini files 


| XXXX.inl | 

XXXX.inl 

XXXX.inl 

XXXX.inl 

XXXX.inl 

XXXX.inl 

XXXX.inl 

XXXX.inl 

XXXX.inl 


Figure 3-3. Files Search Menu 


Simulation Options 


Multi-Stage Liquid Vehicle 
Multi-Stage SRM Vehicle 
Space Shuttle 


Simulation Options 


Nominal Trajectory 
Engine-Out Trajectory 
Branch Traj Eng-Out/Nominal 
Branch Traj Nominal/Eng-Out 


Define Header 


Current Header (hit return if no change) 
TRAJECTORY title 


Figure 3-4. Simulation Option Menus 
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Input Editor 


Use Up and Down Arrow Keys to Move 
Return to Select 

Launch and Initial Conditions 
Thrust Event Related Data 
Propulsion Data 
Aerodynamic Data 
Attitude Control 
Mass Properties 
Environmental Data 
Constants 

Operational Options 
Optimization Data 
Output Options 
Dispersions 

Create/Modify .COM File 
Plot a Data File 
Save Input File 
Quit 


Figure 3-5. MASTRE Interface Main Menu 


Modification of the current file or creation of a new file is also optional to the user after 
making changes to the parameters defined under the main menu. The user also can save the current 
data at any time during execution by selection of the "Save Input File" item on the main menu. During 
execution of the program, the user is asked if he wishes to save the input files after modification of 
these files. 

To modify and review the data, the user must be familiar with the special function keys used 
by the software. The next paragraphs provide a summary of their use and provide special instructions 
for use of the program. 

3.1 FUNCTION KEYS 

To use the User Interface Program, an extended keyboard is required that contains the 
function keys located between the number keypad and the typewriter keys. These function keys 
contain the cursor arrow keys and a grouping of special keys to perform different functions. Figure 3-5 
shows a layout of these keys. Special keys used by the User Interface Program are the Select Key, the 
Remove Key, the Insert Here Key, the Next Scm (Next Screen) Key, the Prev Scrn (Previous Screen) 
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Key, the Find Key, and the Return Key. The following paragraphs define the purpose of these special 
keys. 


Find 


Insert 

Here 


Remove 


Select 


Next 

Scm 



Figure 3-6 . User Interface Function Keys 


3.1.1 Return Key 

The Return Key is used to either terminate a window or denote the completion of data entry 
when using the either the Select Key or the Find Key. 

3.1.2 Cursor Arrow Keys 

The Cursor Arrow Keys are used to move the cursor on the screen in the direction denoted 
by the arrow. The arrow keys are used for both menus and data tables. Menus primarily use the up 
and down Arrow Keys, whereas the data tables use the up, down, left, and right Arrow Keys. Scrolling 
of a data table that continues off the screen is performed by continued pressing of either the up or down 
Arrow Keys. Once the bottom, or top, of the table is reached, continued pressing in the same direction 
will not move the cursor. Scrolling of a menu, however, is different since continued pressing in the 
same direction of the up or down Arrow Keys when at the top or bottom of the menu will send the cursor 
to either the bottom or top of the menu, respectively. 

3.1.3 Select Key 

The Select Key is used to select data on the screen that will be modified. The user must use 
the Arrow Keys to select the data to be modified, by high-lighting the selection with the cursor and 
pressing the Select Key. Once the Select Key is pressed, the user is prompted by a string of minus signs 
(i.e., " — "), the number of minus signs being a function of the number of digits displayed by the data 
table. The user is limited in the input values to the number of digits displayed. If the user 
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indiscriminately presses the Select Key while scanning the data, the original value can be retrieved by 
pressing the Return Key. If the user, while modifying data, puts an erred number (i.e., a number 
containing an alphabetic or special character (other than a decimal point, the letters E or D , or a plus 
or minus sign) the string of minus signs will reappear. The user can either recall the original number 
by pressing the Return Key or type a corrected entry. 

3.1.4 Remove Key 

The Remove Key is used only when data are displayed in a tabular fashion. By placing the 
cursor, via the arrows keys, over any element in a row and pressing the Remove Key, all values 
contained in the rows below the indicated row are moved up, thus removing the indicated row. 

3.1.5 Insert Here Key 

The Insert Here Key is also used only when data are displayed in a tabular fashion. By 
placing the cursor, via the arrows keys, over any element in a row and pressing the Insert Here Key, 
all values contained in the indicated row as well as all rows below the indicated row are moved down. 
Zero values or blanks (depending on whether the data are numeric or characters) are placed in the 
inserted row (which can be changed by the user). 

3.1.6 Next Scrn Key 

The Next Scrn Key is used when there are multiple windows on a single screen. When 
multiple windows are present, the initial placement of the cursor indicates the home window. The 
Next Scrn Key is used to move the cursor from one window to the next. Once the cursor is transferred 
to a window, the arrow keys can then be used to move the cursor on the new window. 

3.1.7 Prev Scrn Key 

The Prev Scrn Key is also used when there are multiple windows on a single screen. The 
Prev Scrn Key allows the user to transfer back from a current window to the "home" or previous 
window. 


3.1.8 Find Key 

The Find Key is used in the command file generation section of the User Interface Program 
(see Section 17) to allow the user to selectively pick from a list of available files when creating or editing 
a command file. 
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3J2 FILE MANAGEMENT 

File management in th© User Interface Program is simplified for the user by menus that 
provide a listing of the current files resident in the directory/subdirectory specified by the user. To 
eliminate the confusion of the user identifying the names of multiple files to provide different types of 
input, input and output files are identified by a variety of extensions that are required for use in the 
User Interface Program. Table 3-1 provides a listing of the extensions for each of the input and output 
types. 


Table 3-1. File Extension Definitions 


Extension 

Pile Type 

INL 

General input Namelist file 

ANL 

Aerodynamic data Namelist file 

ADB 

Nonlinear aerodynamic data base 

WNL 

Weight summary Namelist file 

DSP 

Dispersion parameter file 

PLT 

Output plot file 

JUM 

First-stage jump-start input or output file 

LOX 

LOX input file for special propulsion output 

LH2 

LH2 input file for special propulsion output 

SRM 

SRM thrust input file 

SMI 

SRM mass properties input file 

SMM 

SRM mass properties output file 

TEI 

MPS (throttable) mass properties input file 

TEM 

MPS (throttable) mass properties output file 

NEI 

MPS (non-throt) mass properties input file 

NEM 

MPS (non-throt) mass properties input file 

HMI 

Hybrid engine mass properties input file 

HMM 

Hybrid engine mass properties output file 

MRG 

Merge (mass properties) input file 

MMM 

Merge (mass properties) output file 


Inputting files are provided via menus. Figure 3-3 provided an example of the menu used 
^ selection. The user selects the required file by moving the cursor, via the arrow keys, to the 
desired file name and pressing the Return Key. 
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When creating a file within the program, the user does not have to add the extension. The 
program will add the proper extension unless the user provides an extension denoted by a decimal 
point in the file name. (Warning: When the user is defining an input file name, the file name 
should not contain a decimal point unless an extension is added.) 

3.3 SCROLLING 

Because of the size of many of the input arrays or input items, the data tables associated with 
these arrays occupy more than the screen can display. When this occurs, the program allows the user 
to scroll through the tables. This is done by continuously pressing either the up or down Arrow Keys. 
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4. LAUNCH AND INITIAL CONDITIONS 


The Launch and Initial Conditions menu (see Figure 4-1) consists of parameters associated 
with launch geometric conditions and initial conditions. Data can be changed by the user using the 
up and down Arrow Keys to move the cursor to the desired parameter, hitting the Select Key, keying 
in the changed value, and pressing the Return Key. To exit the window, the user presses the Return 
Key. The definitions of these parameters are defined in Table 4-1. 


Launch and Initial Conditions 


Launch Latitude 

(deg) 

Launch Longitude 

(deg) 

Launch Altitude 

(m) 

Launch Azimuth 

(deg) 

Azimuth (Tail) 

(deg) 

Liftoff Weight 

(lb) 

Initialization Time 

(s) 

Alt Bias at Launch 

(m) 


Figure 4-1. Launch and Initial Conditions Menu 


Table 4-1. Launch and Initial Conditions 


Parameter 

Description 

Units 

Launch Latitude 

Geodetic latitude of launch site 

deg 

Launch Longitude 

Longitude of launch site 

deg 

Launch Altitude 

Altitude of launch site above reference 
ellipse 

m 

Launch Azimuth 

Definition of launch azimuth used to define 
launch plumbline coordinate system 

deg 

Azimuth (tail) 

Azimuthial angle of Orbiter tail at launch 
(used when simulating Space Shuttle) 

deg 

Liftoff Weight 

Tbtal lift-off weight of vehicle at liftoff 

lb 

Initialization Time 

Time after lift-off to begin simulation 
(nonzero if jump start simulation) 

s 

Altitude bias at launch 

Altitude bias used to calculate base force 

m 
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5. THRUST EVENT RELATED DATA 


Parameters associated with thrust events are defined in this section. Figure 5-1 provides a 
display of the parameters, and Table 5-1 provides the definitions of the parameters under this section. 
As shown in Figure 5-2, a matrix of data is displayed with the columns representing the parameters 
and the rows representing each of the thrust events (maximum of 15 thrust events). Data can be 
changed by the user using the up, down, left, and right Arrow Keys to move the cursor to the desired 
parameter, pressing the Select Key, keying in the changed value, and pressing the Return Key. To exit 
the window, the user presses the Return Key. 


Thrust Event Related Data 


Thrust 
Evt Time 
(s) 


Jettison 
Wtg (lb) 


Reference 
Area (m2) 


Print 

Interval 

(s) 


Forward 
Step 
Size (s) 


Backward 
Step 
Size (s) 


Wt Drop 
Time (s) 


Drop Wt 
(lb) 


XXX. XX 

xxxxx 

xxxxx 

xxxxx 

xxxxx 

xxxxx 

xxxxx 


xxxxxx.x XX. XX xx.xx XX. XX XX. XX XXX. xx xxxxx. 


Figure 5-1. Thrust Event Related Data Menu 


If the user wishes to either delete or add a thrust event, the user should place the cursor, via 
the Arrow Keys, over any element of the desired row. Using the Remove Key, the selected row will be 
deleted and all subsequent rows will be moved up. Using the Insert Here Key, the selected row will be 
moved down along with the subsequent rows. The selected row will display zero values that can be 
modified by the user. When deleting or adding thrust events, the user should be careful to change other 
thrust event related data (i.e., general propulsion data associated with thrust events, thrust events per 
stage, attitude control phases, etc.). 

As shown in Table 5-1, the user can use either the jettison weight parameter or the drop 
weight parameter to simulate the jettisoning or dropping of weight at some time. The jettison weight 
parameter is used if the user wishes to jettison the weight at the end of the thrust event. This is 
especially useful if the time interval of the thrust event is an optimization variable that allows the time 
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interval to be modified. The drop weight parameter allows the user to drop the weight during the 
thrust event by defining the drop weight time interval. The drop weight time interval is not an 
optimization parameter and, therefore, does not vary. In most cases, the jettison parameter is the 
parameter of choice since additional thrust events can be used to provide variable weight drop events. 


Table 5-1. Thrust Event Related Data 


Parameter 

Description 

Units 

Thrust Evt Time 

Time interval for each thrust 
event 

s 

Jettison Wtg 

Weight to jettison at the end of 
thrust event per thrust event 

lb 

Reference Area 

Aerodynamic reference area per 
thrust event 

m 2 

Print Interval 

Print interval per thrust event 

s 

Forward Step Size 

Integration step size for forward 
integration per thrust event 

s 

Backward Step Size 

Integration step size for 
backward integration per thrust 
event 

s 

Wt Drop Time 

Time interval from beginning of 
thrust event to drop weight per 
thrust event 

s 

Drop Wt 

Amount of weight to drop at 
weight drop time per thrust event 

lb 








6. STAGE RELATED DATA 


Parameters associated with stages are defined in this section. Figure 6-1 provides a display 
of the parameters, and Table 6-1 provides the definitions of the parameters under this section. As 
shown in Figure 6-1, a matrix of data is displayed with the columns representing each of the stages 
(maximum of five stages) and the rows representing the parameters. Data can be changed by the user 
using the up, down, left, and right Arrow Keys to move the cursor to the desired parameter, pressing 
the Select Key, keying in the changed value, and pressing the Return Key. To exit the window, the 
user presses the Return Key. The insert and delete features discussed in Section 5 are not used on this 
data table. 


Stage Related Data 


Stages 1 2 3 4 5 

Number of Thrust Events 

Propellant Termination 

Branch Option - Optimization 

Flight Perf Reserve Factor 

Characteristic Velocity (fps) 

1st Level of Constant Throt 
2nd Level for Constant Throt 
3rd Level for Constant Throt 
4th Level for Constant Throt 
5th Level for Constant Throt 
6th Level for Constant Throt 
7th Level for Constant Throt 
8th Level for Constant Throt 
9th Level for Constant Throt 
10th Level for Constant Throt 

Figure 6-1. Stage Related Data Menu 
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Table 6-1. Stage Related Data 


Parameter 

Description 

Units 

Number of Thrust Events 

Number of thrust events per stage 

— 

Propellant Tfermi nation 

Nonzero value will indicate that the stage will 
terminate on propellant (the amount of 
propellant is based on the propellant weight 
defined in Section 7 less the inert propellants 
defined in Section 15) 


Branch Option - Optimization 

Nonzero value will indicate that the stage will be 
the branch portion of the branch trajectory. The 
value indicates which intermediate constraint 
will be used to terminate the stage (see Branch 
Trajectory Option under Section 13). 


Plight Performance Reserve 
Factor 

Multiplier factor used to calculate the flight 
performance reserve per stage 

... 

Characteristic Velocity 

Characteristic velocity that is multiplied by 
factor to calculate flight performance reserve 

ft/s 

nth Level for Constant Throt 

Constant throttle level used for constant MPS 
throttle option (10 levels are available) 

... 
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7. PROPULSION DATA 


If the user selects the "Propulsion Data" item in the main menu, the submenu shown in 
Figure 7-1 is displayed. This submenu defines the types of propulsion systems and the associated 
propulsion related data available to the user. The user chooses an item from this submenu by moving 
the cursor, via the up and down Arrow Keys, to the desired selection and pressing the Return Key. The 
user is returned to the submenu after exiting the selection. To return to the main menu, the user must 
select the "Return to Main Menu" item. The items in the submenu are discussed in the next 
paragraphs. 


Propulsion Data 


General Propulsion Data 
Main Propulsion System (MPS) 

Solid Rocket Motors (SRM) 

Liquid Booster Motors (LBM) 

Orbit Maneuver System (OMS) 

Rocket Control System (RCS) 

Return to Main Menu 


Figure 7-2. Propulsion Data Menu 


7.1 GENERAL PROPULSION DATA 

The "General Propulsion Data" item of the propulsion systems submenu is used to define 
general information about the five available propulsion systems. The submenu shown in Figure 7-2 
is displayed to provide the various input tables under this item. Input tables associated with the 
"Individual Engine Data" define the propulsion type, location, and propulsion related data. The 
"Propellant/System" data provide the propellant mass associated with each of the five propulsion 
systems. The "Thrust Event Allocation/System" data define (for each thrust event) the allocation of 
engines based on propulsion system. The "Thrust Event Allocation/Engine data define which engines 
are assigned to each thrust event. The user is returned to the submenu after exiting each of the 
selections. To return to the "Propulsion Data" submenu, the user must select the "Return to Previous 
Menu" item. The following paragraphs will describe the contents of these data tables and explain how 
the user can review and/or modify the data. 


7-1 



General Propulsion Options 


Individual Engine Data 
Propellant/System 
Thrust Event 
Allocation/System 
Thrust Event Allocation/Engine 
Return to Previous Menu 


Figure 7-2. General Propulsion Options Menu 


7.1.1 Individual Engine Data 

Parameters associated with individual engine data are defined in this subsection. 
Figure 7-3 provides a display of the parameters, and Table 7-1 provides the definitions of the 
parameters under this subsection. As shown in Figure 7-3, a matrix of data is displayed with the 
columns representing the parameters and the rows representing each engine (maximum of 15 
engines). Data can be changed by the user using the up, down, left, and right Arrow Keys to move the 
cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. To exit the window, the user presses the Return Key. The insert and delete features 
previously discussed are available on this data table. 


General Propulsion Data 


Engine Types: 1-MPS, 2-SRM, 3-LBM, 4-OMS, 5-RCS, 6-Fixed MPS 

Eneine Normal Lateral Pitch Yaw Vacuum Exit 

Tv™ Position Position Position Angle Angle Thrust F ,°™ te Area 

_ (m) (m) (m) (deg) (deg) (lb) (lb/s) (m 2 ) 

1 

1 

1 

1 


Figure 7-3. General Propulsion Data Menu 
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Table 7-1. Individual Engine Data 


Parameter 

Description 

Units 

Engine Type 

Engine type flag: 1 - MPS, 2 - SRM, 3 - 
LBM, 4 - OMS, 3 - RCS, 6 - Fixed MPS 

... 

Long Position 

Longitudinal position of engine gimbal 
point 

m 

Normal Position 

Normal position of engine gimbal point 

m 

Lateral Position 

Lateral position of engine gimbal point 

m 

Pitch Angle 

Pitch cant angle if fixed engine 

deg 

Yaw Angle 

Yaw cant angle if fixed engine 

deg 

Vacuum Thrust 

Vacuum thrust of engine 

lb 

Flowrate 

Propellant flowrate of engine 

lb/s 

Exit Area 

Exit area of engine 

m 2 


7.1.2 Propellant Per System 

Parameters associated with propulsion system propellant are defined in this subsection. 
Figure 7-4 provides a display of the parameters, and Table 7-2 provides the definitions of the 
parameters under this subsection. As shown in Figure 7-4 , data are displayed representing each of 
the propellant systems. Data can be changed by the user using the up and down Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. To exit the window, the user presses the Return Key. The insert and delete features 
previously discussed are not used on this data table. 


Propellant System 


Main Propulsion System Prop (lb) 

Solid Rocket Motor Prop (lb) 

Liquid Booster Module Prop (lb) 

Orbit Maneuver System Prop (lb) 

Rocket Control System Prop (lb) 


Figure 7-4 . Propellant Menu 
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Table 7-2. Propellant Weight Data 


Parameter 

Description 

Units 

Main Propulsion System Prop 

MPS total propellant weight 

lb 

Solid Rocket Motor Prop 

Solid propulsion system total 
propellant weight 

lb 

Liquid Booster Module Prop 

LBM propellant weight 

lb 

Orbit Maneuver System Prop 

OMS propellant weight 

lb 

Rocket Control System Prop 

RCS propellant weight 

lb 


7.1.8 Thrust Event Dependent Allocation Per System 

Parameters associated with thrust event related data are defined in this subsection. 
Figure 7-5 provides a display of the parameters under this subsection. As shown in Figure 7-5, a 
matrix of data is displayed with the columns representing the parameters and the rows representing 
each of the thrust events (maximum of 15 thrust events). Data can be changed by the user using the 
up, down, left, and right Arrow Keys to move the cursor to the desired parameter, pressing the Select 
Key, keying in the changed value, and pressing the Return Key. To exit the window, the user presses 
the Return Key. 


1 

2 

3 

• 

15 


General Propulsion Data 


Thrust 

Event 


The number of engines of each propulsion 
system per thrust event 


MPS 


SRM 


LBM QMS RCS 


Fixed 

MPS 


Figure 7-5. Thrust Event Allocation Per System Menu 
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The insert and delete features previously discussed are available on this data table. If adding 
or deleting records, the user should be sure to change other thrust event related data in other menus. 

7.1.4 Thrust Event Dependent Allocation Per Engine 

Parameters associated with thrust event dependent engine allocation data are defined in this 
subsection. Figure 7-6 provides a display of the parameters under this subsection. As shown in 
Figure 7-6, a matrix of data is displayed with the columns representing each of possible 15 engines 
and the rows representing zero and nonzero values, which indicate passive or active engines, 
respectively, for each thrust event (maximum of 15 thrust events). Data can be changed by the user 
using the up, down, left, and right Arrow Keys to move the cursor to the desired parameter, pressing 
the Select Key, keying in the changed value, and pressing the Return Key. To exit the window, the 
user presses the Return Key. The insert and delete features previously discussed are available on this 
data table. 


Engines/Thrust Event 


Thrust Event 
Number 


Engine Numbers 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


1 

2 


15 


Figure 7-6. Engines Per Thrust Event Menu 


73. MAIN PROPULSION SYSTEM 

If the "Main Propulsion System" item is selected under the propulsion system submenu, the 
submenu shown in Figure 7-7 is displayed. Items under this submenu provide the inputs for the 
various MPS propulsion options available to the user. The thrust options are defined by the user as a 
function of thrust event and are described under the "Thrust Event Related Data" input tables. These 
thrust options directly relate to the "Throttle Tables" and "Thrust Tailoff Tables" item input tables. 
The input table under the "Minimum Throttle Limit" item provide an altitude dependent method of 
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limiting the minimum value of the throttle. The "Specific Impulse Tables" item provides a stage 
dependent method for allowing specific impulse to be a function of time from lift-off. The "Constants" 
item provides additional data. The user is returned to the submenu after exiting the selected item. To 
return to the "Propulsion Data" submenu, the user must select the "Return to Previous Menu" item. 
The following subsections define the input parameters and the user requirements to review and/or 
modify the data. 


MPS Data 


Select from the following: 

Thrust Event Related Data 
Throttle Tables 
Minimum Throttle Limit 
Thrust Tailoff Tables 
Specific Impulse Tables 
Constants 

Return to Previous Menu 


Figure 7-7. MPS Data Menu 


7.2.1 Thrust Event Related Data 

Propulsion parameters associated with MPS thrust event related data are defined in this 
subsection. Figure 7-8 provides a display of the parameters, and Table 7-3 provides the definitions 
of the parameters under this subsection. As shown in Figure 7-8 , a matrix of data is displayed with 
the columns representing the parameters and the rows representing each of the thrust events 
(maximum of 15 thrust events). Data can be changed by the user using the up, down, left, and right 
Arrow Keys to move the cursor to the desired parameter, pressing the Select Key, keying in the 
changed value, and pressing the Return Key. To exit the window, the user presses the Return Key. 
The insert and delete features previously discussed are available on this data table. 
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General Propulsion Data 


Thrust Options: 

1 - Normal operations, 2 - Throttle table used, 3 - Qmax throttle, 
4 - Acc limit (maintain limit), 5 - Acc limit (constant throttle), 
and 6 - Use tail-off tables 

Thrust 

Event 

“ Thrust Acc Throttle 

Engines Option Limit Nominal 

1 

2 

• 

• 

• 


15 



Figure 7-8. Thrust Event MPS Data Menu 


Table 7-3 . MPS Thrust Event Data 


Parameter 

Description 

Units 

Number of Engines 

Tbtal number of MPS engines per thrust event 

... 

Thrust Option 

MPS thrust option per thrust event: 

1. Uses nominal throttle value; 

2. Uses throttle table; 

3. Uses throttle table that allows variable times and 
values to impose maximum dynamic pressure 
constraint; 

4. Uses nominal throttle value until acceleration limit is 
reached, after which throttle is varied to maintain 
constant acceleration; 

5. Same as four but throttle after acceleration limit is 
based on stage dependent constant values (see 
Section 6); 

6. Uses thrust tailoff tables on throttled engines and 
nominal values of MPS throttle 


Acc Limit 

Acceleration limit used for thrust options 4 and 5 per thrust event 

g’s 

Throttle Nominal 

Nominal value of throttle used for MPS engines per thrust event 

... 


7*2*2 Throttle Tables 

Parameters associated with MPS throttle tables are defined in this subsection. Figure 7-9 
provides a display of the parameters, and Table 7-4 provides the definitions of the parameters under 
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this subsection. As shown in Figure 7-9, a matrix of data is displayed with the columns representing 
the parameters and the rows representing each of the data items (maximum of 15 data items). Data 
can be changed by the user using the up, down, left, and right Arrow Keys to move the cursor to the 
desired parameter, pressing the Select Key, keying in the changed value, and pressing the Return Key. 
To exit the window, the user presses the Return Key. The insert and delete features previously 
discussed are available on this data table. 



Table 7-4 . MPS Throttle Tables Data 


Parameter Description Units 

Time Table Time from lift-off s 

Throttle Table MPS throttle factor 

7.2.3 Minimum Throttle Limit 

Parameters associated with MPS minimum throttle data are defined in this subsection 
Figure 7 -10 provides a display of the parameters, and Table 7-5 provides the definitions of the 
parameters under this subsection. As shown in Figure 7-10 , a matrix of data is displayed with the 
columns representing the parameters and the rows representing each of the data items (maximum of 
five data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to 
move the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and 
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pressing the Return Key. To exit the window, the user presses the Return Key. The insert and delete 
features previously discussed are available on this data table. 


MPS Minimum Throttle Data 


Altitude Throttle 

Index Table Table 

(ft) (-) 


1 

2 

3 

4 

5 


Figure 7-10. MPS Minimum Throttle Data Menu 


Table 7-5. MPS Minimum Throttle Data 


Parameter 

Description 

Units 

A] ti tude Table 

Altitude table 

ft 

Throttle Table 

Minimum MPS throttle value 

— 


7.2.4 Thrust Tailoff Tables 

Parameters associated with MPS thrust tailoff data are defined in this subsection. Figure 
7-11 provides a display of the parameters, and Table 7-6 provides the definitions of the parameters 
under this subsection. As shown in Figure 7-11, a matrix of data is displayed with the columns 
representing the parameters and the rows representing each of the data items (maximum of 15 data 
items). Data can be changed by the user using the up, down, left, and right Arrow Keys to move the 
cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. To exit the window, the user presses the Return Key. The insert and delete features 
previously discussed are available on this data table. 
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MPS Tailoff Data 


Index 


Time Throttle 
Table Table 

(ft) (-) 


1 

2 


Engines 
Tb Throt 

(~) 


15 


Figure 7-11. MPS Tailoff Data Menu 


Table 7-6. MPS Thrust Tailoff Data 


Parameter 

Description 

Units 

Time Table 

Relative time from beginning of thrust event 

s 

Throttle Table 

MPS tailoff throttle value 



Engines to Throt 

Number of MPS engines to throttle 

— 


7.2.5 Specific Impulse Tables 

Parameters associated with MPS Specific Impulse are defined in this subsection. Figures 
7-12 and 7-13 provide a display of the parameters, and Table 7-7 provides the definitions of the 
parameters under this subsection. As shown in Figures 7-12 and 7-13, a matrix of data is displayed 
with the columns representing the parameters and the rows representing each of the data items 
(maximum of three tabular values). Data can be changed by the user using the up, down, left, and right 
Arrow Keys to move the cursor to the desired parameter, pressing the Select Key, keying in the 
changed value, and pressing the Return Key. The first- through third-stage data shown in Figure 7-12 
is the first data displayed. To exit to the fourth- and fifth-stage specific impulse (Isp) table (J Figure 
7-13), the user presses the Return Key. Modifications to this table are performed in the same manner. 
To exit this window, the user presses the Return Key. The insert and delete features previously 
discussed are available on this data table. 


7-10 





MPS Specific Impulse Data 


1st 

Index Throttle 

(...) 


Isp 

Table 

(s) 


2nd 

Stage 

Throttle 

(...) 


Isp 

Table 

(s) 


3rd 

Stage 

Throttle 

(...) 


Isp 

Table 

(s) 


1 

2 

3 


Figure 7-12. MPS Specific Impulse Data Menu 
(First- Through Third-Stage Data) 


MPS Specific Impulse Data 


4th t 5th j 

!"<*«■ Throttle Throttle 

(...) <s) (-) <S) 


1 

2 

3 


Figure 7-13. MPS Specific Impulse Data Menu 
(Fourth- and Fifth-Stage Data) 


Table 7- 7. MPS Specific Impulse Data 


Parameter 

Description 

Units 

Throttle Level 
Isp Table 

Throttle level history 
MPS specific impulse 

s 


7.2.6 Constants 

Parameters associated with MPS constants are defined in this subsection. Figure 7-14 
provides a display of the parameters, and Table 7-8 provides the definitions of the parameters under 
this subsection. As shown in Figure 7-14, data is displayed with to the right of the parameter names. 
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Data can be changed by the user using the up and down Arrow Keys to move the cursor to the desired 
parameter, pressing the Select Key, keying in the changed value, and pressing the Return Key. To exit 
the window, the user presses the Return Key. The insert and delete features previously discussed are 
not used on this data table. 


MPS Constants 


Mixture Ratio 
Propellant Margin 1 
Propellant Margin 2 


Figure 7-14. MPS Constanta Data Menu 


Table 7-8. MPS Constants Data 


Parameter 

Description 

Units 

Mixture Ratio 

MPS mixture ratio of LH2 to LOX 
propellant 

... 

Propellant Margin 1 

MPS propellant margin remaining when 
using the propellant termination option 

lb 

Propellant Margin 2 

MPS propellant margin remaining when 
using the propellant termination option 

lb 


7 .3 SOLID ROCKET MOTORS 

If the Solid Rocket Motors item is selected in the propulsion system submenu, the submenu 
shown in Figure 7-15 is displayed. SRM data input is stored on a separate file; therefore, the user is 
required to load the appropriate file. The data on this file can be reviewed and/or modified by use of 
the input tables under the "Review/Modify Data” item of the submenu. If SRM data are not read from 
a file, zero values will be displayed on the input tables. The user is returned to this submenu after 
exiting the selected item. To return to the "Propulsion Data” submenu, the user must select the 
Return to Previous Menu" item. Upon exiting, the user is asked if the data are to be stored or not. If 
it is to be stored, the user can either store the new data under the existing file name or a new file name. 
The following subsections describe the submenu items. 
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Solid Rocket Data 


Load SRM File 
Review/Modify Data 
Return to Main Menu 


Figure 7-15. Solid Rocket Data Menu 


7.3.1 Load SRM File 

Input Files for the SRM data are stored with a ".SRM" extension. System routines are used 
to search the user-defined directory for Files that have the M .SRM" extension. After Finding the files, 
the software displays the File names so that the user can select the appropriate file. The selection is 
made by moving the cursor, via the Arrow Keys, to the selected File and pressing the Return Key. 

If no files are found during the search, the user will be prompted ’’There are no files with 
that extension! Look for another extension? (y/n).” If the user responds with a "Y" or M y”, an 
additional prompt "enter ext" will be displayed asking the user to define the new three-character 
extension. The user may also define a different resident directory. A new search will take place after 
this. If the user responds with a "N" or "n", the search is terminated and no data are loaded. 

7.3.2 Review/Modify Data 

Propulsion parameters associated with SRMs are defined in this subsection. Figure 7-16 
provides a display of the parameters, and Table 7-9 provides the definitions of the parameters under 
this subsection. As shown in Figure 7-16, a matrix of data is displayed with the columns representing 
the parameters and the rows representing the indices of the tables (maximum of 600 data items per 
table). Data can be changed by the user using the up, down, left, and right Arrow Keys to move the 
cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. Due to the large number of data items, the user can utilize the scrolling feature to 
review and/or modify the data. To exit the window, the user presses the Return Key. The insert and 
delete features previously discussed are available on this data table. 
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SRM Data 


Time Thrust Flowrate Exit Area 
Index Table Table Table Table 

(s) (lb) (lb/s) (ft 2 ) 


1 

2 


600 


Figure 7-16. SRM Data Menu 


Table 7-9. SRM Propulsion Data 


Parameter 

Description 

Units 

Time Table 

Time from lift-off 

s 

Thrust Table 

Vacuum thrust of single engine 

lb 

Flowrate Table 

Vacuum propellant flowrate 

lb/s 

Exit Area Table 

Exit area of SRM nozzle 

ft 2 


1A LIQUID BOOST MODULE 

Propulsion parameters associated with a LBM propulsion system are defined in this 
subsection. Figure 7-17 provides a display of the parameters, and Table 7-10 provides the definitions 
of the parameters under this subsection. As shown in Figure 7-17, a matrix of data is displayed with 
the columns representing the parameters and the rows representing each of the data items (maximum 
of 30 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to 
move the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and 
pressing the Return Key. Due to the large number of data items, the user can utilize the scrolling 
feature to review and/or modify the data. To exit the window to the "Propulsion Data" submenu, the 
user presses the Return Key. The insert and delete features previously discussed are available on this 
data table. 
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LBM Data 


Index 


1 

2 

• 


Time Thrust Flowrate 

Table Table Table 

(s) (lb) (lb/s) 


30 


Figure 7-17 . LBM Data Menu 


Table 7-10. LBM Propulsion Data 


Parameter 

Description 

Units 

Time Table 

Time from lift-off 

s 

Thrust Table 

Vacuum thrust of LBM system 

lb 

Flowrate Thble 

Vacuum flowrate of LBM system 

lb/s 


7.5 ORBIT MANEUVER AND ROCKET CONTROL SYSTEMS 

Propulsion parameters associated with OMS and RCS propulsion systems are defined in this 
subsection. Figure 7-18 provides a display of the parameters, and Table 7-11 provides the definitions 
of the parameters under this section. As shown in Figure 7 -18, a matrix of data is displayed with the 
columns representing the parameters and the rows representing each of the data items (maximum of 
15 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. To exit the window to the "Propulsion Data" submenu, the user presses the Return 
Key. The insert and delete features previously discussed are available on this data table. 
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OMS/RCS Data 



OMS 

OMS 

Dump 

RCS 

RCS 

Index 

Thrust 

Flowrate 

Flowrate 

Thrust 

Flowrate 


(lb) 

(lb/s) 

(lb/s) 

(lb) 

(Ib/s) 


1 

2 


15 


Figure 7-18. OMS and RCS Data Menu 


Table 7-11. OMS and RCS Propulsion Data 


Parameter 

Description 

Units 

OMS Thrust 

OMS vacuum thrust 

lb 

OMS Flowrate 

OMS vacuum propellant flowrate 

lb/s 

Dump Flowrate 

Flowrate of total propellant dumped 
through the OMS/RCS interconnect system 

lb/s 

RCS Thrust 

RCS vacuum thrust 

lb 

RCS Flowrate 

RCS vacuum propellant flowrate 

lb/s 
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8. AERODYNAMIC DATA 


If the user selects the "Aerodynamic Data" item in the main menu, the submenu shown in 
Figure 8-1 is displayed. This submenu defines the types of aerodynamic related data available to the 
user. The user chooses an item from this submenu by moving the cursor, via the up and down Arrow 
Keys, to the desired selection and pressing the Return Key. The user is returned to the submenu after 
exiting the selection. To return to the main menu, the user must select the "Return to Main Menu" 
item and presses the Return Key. The items in the submenu are discussed in the next paragraphs. 


Aerodynamic Options 


Load Aero Namelist 
Review/Modify Data 
Additional Aero Data 
Dispersion Data 
Return to Main Menu 


Figure 8-1. Aerodynamic Options Menu 


8.1 LOAD AERO NAMELIST 

Although the MASTRE Program allows the simulation of both nonlinear and linear 
aerodynamic data, the User Interface Program is used to review and/or modify the linear aerodynamic 
data only. Therefore, the input files that are loaded here relate to the linear aerodynamics. The 
nonlinear aerodynamic data uses a different file and is defined in the execution command file (see 
Section 17). Input files for the linear aerodynamic data are stored with an ".ANL" extension. System 
routines are used to search the user-defined directory for files that have the ".ANL" extension. After 
finding the files, the software displays the file names such that the user can select the appropriate file. 
The selection is made by moving the cursor, via the Arrow Keys, to the selected file and pressing the 
Return Key. 

If no files are found during the search, the user will be prompted "There are no files with 
that extension! Look for another extension? (y/n) M . If the user responds with a "Y" or "y", an 
additional prompt "enter ext" will be displayed asking the user to define the new three -character 
extension. The user may also select another resident directory. A new search will take place after this. 
If the user responds with a "N" or "n", the search is terminated and no data are loaded. 


8-1 




8.2 REVIEW/MODIFY DATA 

Selecting the Review/Modify Dstd item of the Aerodynamics Options" submenu results in 
the submenu shown in Figure 8-2. The items of this submenu provide the different types of 
aerodynamic data available. The user selects from this submenu by moving the cursor with the up and 
down Arrow Keys and pressing the Return Key. Upon exiting from the selected item, the user is 
returned to this submenu. To exit this submenu to the "Aerodynamic Options" submenu, the user must 
select the "Return to Previous Menu" item. 


Aerodynamic Data 


Linear Aero 
Base Force Data 
Elevon Data 

Hypersonic Viscous Interaction 
Return to Previous Menu 


Figure 8-2. Aerodynamic Data Menu 


8.2.1 Linear Aerodynamic Data 

Parameters associated with linear aerodynamic data are defined in this subsection. The first 
display the user sees after selecting "Linear Aero" is the question shown in Figure 8-3 . A "yes" answer 
to this question means that the linear aerodynamics defined in this subsection will be used in the entire 
trajectory. A no answer indicates that nonlinear aerodynamics will be used for the first stage, and 
the linear aerodynamics defined in this subsection will be used in the upper stages. The nonlinear 
aerodynamics, which are primarily used when simulating the Space Shuttle, use data from a data base 
file that is defined in the user's command file (see Section 17). 


Will linear aero be used for the entire traj ? (y/n) 

Figure 8-3. Linear Aero Selection 


After answering the question, the top window in Figure 8-4 is displayed. Figure 8-4 shows 
the two windows used to display the aerodynamic parameters, and Table 8-1 provides the definitions 
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of the parameters under this subsection. The values of aerodynamic data parameters are based on the 
aerodynamic input files defined under Subsection 8.1; therefore, these files must be loaded previously. 
Otherwise, zero values will be displayed. As shown in Figure 8-4, a matrix of data for each window is 
displayed with the columns representing the aerodynamic parameters and the rows representing each 
of the data items (maximum of 25 data items). Data can be changed by the user by using the up, down, 
left, and right Arrow Keys to move the cursor to the desired parameter, pressing the Select Key, keying 
in the changed value, and pressing the Return Key. Due to the number of data items exceeding the 
window size, the user can utilize the scrolling feature to review and/or modify the data. To exit each 
window, the user presses the Return Key. 


Linear Aero Data 


Mach CAo CAalp CNo CNalp Cmo Cmalp 

Index w P Table Table Table Table Table Table 
7*T (-) (/deg) (-) (/deg) (-) (/deg) 


1 

2 


25 


Linear Aero Data 


Mach CYo cybeta 

Index owli r Table Table 

Table (...) (/deg) 


Cno Cnbeta Clo Clbeta 
Table Table Table Table 

(-) (/deg) (-) (/deg) 



Figure 8-4. Linear Aerodynamic Data Menu 
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Table 8-1. Linear Aerodynamic Data 


Parameter 

Description 

Units 

Mach Number Table 

Mach number independent table 

— 

CAo Table 

Axial force coefficient at zero AOA 



CAalp Table 

Axial force slope coefficient with respect to AOA 

/deg 

CNo Table 

Normal force coefficient at zero AOA 

— 

CNalp Thble 

Normal force slope coefficient with respect to AOA 

/deg 

Cmo Table 

Pitching moment coefficient at zero AOA 

... 

Cmalp Thble 

Pitching moment slope coefficient with respect to AOA 

/deg 

CYo Table 

Side force coefficient at zero sideslip angle 

-- 

CYbeta Thble 

Side force slope coefficient with respect to sideslip angle 

/deg 

Cno Thble 

Yawing moment coefficient at zero sideslip angle 

... 

Cnbeta Table 

Yawing moment slope coefficient with respect to sideslip angle 

/deg 

Clo Thble 

Rolling moment coefficient at zero sideslip angle 

— 

Cl beta Table 

Rolling moment slope coefficient with respect to sideslip angle 

/deg 


If the user wishes to either delete or add a data item row, the user should place the cursor, 
via the Arrow Keys, over any element of the desired row. Using the Remove Key, the selected row will 
be deleted and all subsequent rows will be moved up. Using the Insert Here Key, the selected row will 
move down along with subsequent rows. The selected row will display zero values, which can be 
modified by the user. Since the same independent Mach table is used for all aerodynamic coefficients, 
if a row is deleted or added in one of the displays, the other display will reflect the same change. 

8.2.2 Base Force Data 

Selecting the Base Force Data" item of the "Aerodynamics Data" submenu results in the 
submenu shown in Figure 8-5. The items of this submenu provide the different types of base force 
data available. The user selects from this submenu by moving the cursor with the up and down Arrow 
Keys and pressing the Return Key. Upon exiting from the selected items, the user is returned to this 
submenu. To exit this submenu to the "Aerodynamic Data" submenu, the user must select the "Return 
to Previous Menu" item. 
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Base Force Options 


First Stage 

Upper Stage Engine Out 
Upper Stage Nominal 
Coefficients 

Return to Previous Menu 


Figure 8-5. Base Force Options Menu 


8.2.2.1 First-Stage Base Force Data 

Parameters associated with first-stage base force data are defined in this subsection. 
Figure 8-6 provides a display of the parameters, and Table 8-2 provides the definitions of the 
parameters under this subsection. As shown in Figure 8-6, a matrix of data is displayed with the 
columns representing the parameters and the rows representing each of the data items (maximum of 
50 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. Due to the number of data items exceeding the window size, the user can utilize the 
scrolling feature to review and/or modify the data. To exit the window, the user presses the Return 
Key. The insert and delete features previously discussed are available on this data table. 


Base Force Data 


First Stage 
Nominal 
Index 


Altitude 

Table 

(ft) 


Axial 

Table 

(lb) 


Normal 

Table 

(lb) 


Pitch Mom 
Table 
(ft-lb) 


Ref Dyn 
Table 
(psf) 


1 

2 

• 

50 


Figure 8-6. First-Stage Base Force Data Menu 
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Table 8-2. First-Stage Base Force Data 


Parameter 

Description 

Units 

Altitude Thble 

Altitude independent table 

ft 

Axial Table 

Base force axial force 

lb 

Normal Ikble 

Base force normal force 

lb 

Pitch Mom Thble 

Pitching moment due to base force 

ft-lb 

Ref Dyn Table 

Reference dynamic pressure 

psf 


8«2.2*2 Upper-Stage Engine-Out Base Force Data 

Parameters associated with upper-stage engine-out base force data are defined in this 
subsection. Figure 8-7 provides a display of the parameters, and Table 8-3 provides the definitions 
of the parameters under this subsection. As shown in Figure 8-7, a matrix of data is displayed with 
the columns representing the parameters and the rows representing each of the data items (maximum 
of 50 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to 
move the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and 
pressing the Return Key. Due to the number of data items exceeding the window size, the user can 
utilize the scrolling feature to review and/or modify the data. To exit the window, the user presses the 
Return Key. The insert and delete features previously discussed are available on this data table. 


Base Force Data 


Upper Stage Altitude Axial Normal Pitch Mom 
Engine-Out Table Table Table Table 

Index (ft) (lb) (lb) (ft-lb) 


1 

2 

• 

50 


Figure 8-7. Upper-Stage Engine-Out Base Force Data Menu 
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Table 8-3. Upper-Stage Engine-Out Base Force Data 


Parameter 

Description 

Units 

Altitude Table 

Altitude independent table 

ft 

Axial Table 

Base force axial force 

lb 

Normal Table 

Base force normal force 

lb 

Pitch Mom Table 

Pitching moment due to base force 

ft-lb 


8.2.2.S Upper-Stage Nominal Base Force Data 

Parameters associated with upper-stage nominal base force data are defined in this 
subsection. Figure 8-8 provides a display of the parameters, and Table 8-4 provides the definitions 
of the parameters under this subsection. As shown in Figure 8-8, a matrix of data is displayed with 
the columns representing the parameters and the rows representing each of the data items (maximum 
of 50 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to 
move the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and 
pressing the Return Key. Due to the number of data items exceeding the window size, the user can 
utilize the scrolling feature to review and/or modify the data. To exit the window, the user presses the 
Return Key. The insert and delete features previously discussed are available on this data table. 


Base Force Data 


Upper Stage 
Nominal 
Index 


1 

2 

• 

50 


Altitude 

Table 

(ft) 


Axial 

Table 

(lb) 


Normal 

Table 

(lb) 


Pitch Mom 
Table 
(ft-lb) 


Figure 8-8. Upper-Stage Nominal Base Force Data Menu 


8-7 









Table 8-4. Upper-Stage Nominal Base Force Data 


Parameter 

Description 

Units 

Altitude Ikble 

Altitude independent table 

ft 

Axial Table 

Base force axial force 

lb 

Normal Table 

Base force normal force 

lb 

Pitch Mom Table 

Pitching moment due to base force 

ft-lb 


8 .2.2.4 Base Force Coefficients Tables 

Parameters associated with base force coefficients data are defined in this subsection. 
Figure 8-9 provides a display of the parameters, and Table 8-5 provides the definitions of the 
parameters under this subsection. As shown in Figure 8-9, a matrix of data is displayed with the 
columns representing the parameters and the rows representing each of the data items (maximum of 
50 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. Due to the number of data items exceeding the window size, the user can utilize the 
scrolling feature to review and/or modify the data. To exit the window, the user presses the Return 
Key. The insert and delete features previously discussed are available on this data table. 


Base Force Data 


Index 


Altitude 

Table 

(ft) 


Alp Coeff 
Table 
(/rad) 


Betta Coeff 
Table 
(/rad) 


Throt Coeff 
Table 
(...) 


Throt Slope 
Table 
(...) 


1 

2 

• 

50 


Figure 8-9. Base Force Coefficients Menu 
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Table 8-5. Base Force Coefficients Data 


Parameter 

Description 

Units 

Altitude Table 

Altitude independent table 

ft 

Alp Coeff Table 

Coefficient used with angle of attack 

/rad 

Beta Coeff Table 

Coefficient used with sideslip angle 

/rad 

Throt Coeff Tkble 

Coefficient used with throttle 

... 

Throt Slope Table 

Slope coefficient used with throttle 

— 


8.2.3 Elevon Data 

Aerodynamic parameters associated with elevon data are defined in this subsection. Figure 
8-10 provides a display of the parameters, and Table 8-6 provides the definitions of the parameters 
under this subsection. As shown in Figure 8-10, a matrix of data is displayed with the columns 
representing the elevon parameters and the rows representing each of the data items (maximum of 25 
data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. Due to the number of data items exceeding the window size, the user can utilize the 
scrolling feature to review and/or modify the data. To exit the window, the user presses the Return 
Key. The insert and delete features previously discussed are available on this data table. 


Elevon Data 


Index 


RelVel 

Table 

(ft/s) 


Inbd Def 
Sch 6 
(deg) 


Outbd Def 
Sch 6 
(deg) 


Mach Number 
Table 

(...) 


Inbd Def 
Table 
(deg) 


Outbd Def 
Table 
(deg) 


1 

2 

• 

25 


Figure 8-10. Elevon Data Menu 
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Table 8-6. Elevon Data 


Parameter 

Description 

Units 

Rel Vel Table 

Earth-fixed relative velocity 
independent table for Schedule 6 
inboard and outboard deflection angles 

ft/s 

Inbd Def Sch 6 

Inboard deflection angle based on 
Shuttle control Schedule 6 

deg 

Outbd Def Sch 6 

Outboard deflection angle based on 
Shuttle control Schedule 6 

deg 

Mach Number 
Tkble 

Mach number independent table for 
inboard and outboard deflection angles 

— 

Inbd Def Table 

Active inboard deflection angle 

deg 

Outbd Def Table 

Active outboard deflection angle 

deg 


8.2.4 Hypersonic Viscous Interaction Data 

Aerodynamic parameters associated with hypersonic viscous interaction data are defined in 
this subsection. Figure 8-11 provides the three displays of the parameters, and Table 8-7 provides 
the definitions of the parameters under this subsection. As shown in Figure 8-11, a matrix of data is 
displayed with the columns representing the parameters and the rows representing each of the data 
items (maximum of 10 data items). Data can be changed by the user using the up, down, left, and right 
Arrow Keys to move the cursor to the desired parameter, pressing the Select Key, keying in the 
changed value, and pressing the Return Key. To exit each window, the user presses the Return Key. 
The insert and delete features previously discussed are available on this data table. 
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Viscous Interaction Data 


Mach Number 
Index Table 

(...) 


Ca Cont 
Const 
(...) 


Ca Cont 
Slope 
(/deg) 


Ca Cont 
Acc 
(/deg 2 ) 


Ca Mole 
Const 
(...) 


Ca Mole 
Slope 
(/deg) 


Ca Mole 
Acc 
(/deg 2 ) 



Mach Number Cn Cont Cn Cont Cn Cont Cn Mole Cn Mole Cn Mole 
Index Table Const Slope Acc Const Slope Acc 

(— ) (---) (/deg) (/deg 2 ) (— ) (/deg) (/deg 2 ) 




Mach Number 

Cm Cont 

Cm Cont 

Cm Cont 

Cm Mole 

Cm Mole 

Cm Mole 

Index 

Table 

Const 

Slope 

Acc 

Const 

Slope 

Acc 


(...) 

(...) 

(/deg) 

(/deg 2 ) 

(...) 

(/deg) 

(/deg 2 ) 

1 

2 

• 










Figure 8-11. Viscous Interaction Data Menu 
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Table 8-7. Hypersonic Viscous Interaction Data 


Parameter 

Description 

Units 

Mach Number Table 

Mach number 

... 

Ca Cont Const 

Continuum flow axial force constant coefficient 

... 

Ca Cont Slope 

Continuum flow axial force slope coefficient 

— 

Ca Cont Acc 

Continuum flow axial force acceleration coefficient 

/deg 2 

Ca Mole Const 

Free molecular flow axial force constant coefficient 

— 

Ca Mole Slope 

Free molecular flow axial force slope coefficient 

/deg 

Ca Mole Acc 

Free molecular flow axial force acceleration coefficient 

/ deg 2 

Cn Cont Const 

Continuum flow normal force constant coefficient 

... 

Cn Cont Slope 

Continuum flow normal force slope coefficient 

/deg 

Cn Cont Acc 

Continuum flow normal force acceleration coefficient 

/ deg 2 

Cn Mole Const 

Free molecular flow normal force constant coefficient 

... 

Cn Mole Slope 

Free molecular flow normal force slope coefficient 

/deg 

Cn Mole Acc 

Free molecular flow normal force acceleration coefficient 

/ deg 2 

Cm Cont Const 

Continuum flow pitching moment constant coefficient 

... 

Cm Cont Slope 

Continuum flow pitching moment slope coefficient 

/deg 

Cm Cont Acc 

Continuum flow pitching moment acceleration coefficient 

/deg 2 

Cm Mole Const 

Free molecular flow pitching moment constant coefficient 

... 

Cm Mole Slope 

Free molecular flow pitching moment slope coefficient 

/ deg 

Cm Mole Acc 

Free molecular flow pitching moment acceleration coefficient 

/deg 2 


8.3 ADDITIONAL AERO DATA 

Parameters associated with additional aerodynamic data are defined in this subsection. 
Figure 8-12 provides a display of the parameters, and Table 8-8 provides the definitions of the 
parameters under this section. As shown in Figure 8-12, data is displayed with the columns 
representing the parameters. Data can be changed by the user using the up and down Arrow Keys to 
move the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and 
pressing the Return Key. To exit the window, the user presses the Return Key. The insert and delete 
features previously discussed are not used on this data table. 
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Additional Aero Data 


Reference Length (ft), 1st Stage 
Reference Length (ft), Other 
Axial Moment Reference Pt (ft), 1st Stage 
Axial Moment Reference Pt (ft), Other 
Normal Moment Reference Pt (ft), 1st Stage 
Normal Moment Reference Pt (ft), Other 
Thrust Event to Begin Const Base Force 
Value of Const Base Force (lb) 

Thrust Event to Begin Disperison Aero 


Figure 8-12 . Additional Aerodynamic Data Menu 


Table 8-8. Additional Aerodynamic Data 


Parameter 

Description 

Units 

Reference Length - 
1st Stage 

Aerodynamic reference length for first 
stage 

ft 

Reference Length - 
Other 

Aerodynamic reference length for upper 
stages 

ft 

Axial Moment 
Reference Pt. - 1st Stage 

Aerodynamic axial moment reference 
point for first stage 

ft 

Axial Moment 
Reference Pt. - Other 

Aerodynamic axial moment reference 
point for upper stages 

a 

Normal Moment 
Reference Pt. - 1st Stage 

Aerodynamic normal moment reference 
point for first stage 

ft 

Normal Moment 
Reference Pt. - Other 

Aerodynamic normal moment reference 
point for upper stages 

ft 

Thrust Event to 
Begin Const Base Force 

Index of thrust event to begin constant 
base force 

... 

Value of Const Base 
Force 

Value of constant base force 

lb 

Thrust Event to Begin 
Dispersion Aero 

Index of thrust event to begin use of 
dispersion aerodynamics 

... 


8.4 DISPERSION DATA 

Parameters associated with aerodynamic dispersion data are defined in this subsection. 
Figure 8-13 provides a display of the parameters, and Table 8-9 provides the definitions of the 
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parameters under this section. As shown in Figure 8-13, a matrix of data is displayed with the 
columns representing the parameters and the rows representing each of the data items (maximum of 
25 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. Due to the number of data items exceeding the window size, the user can utilize the 
scrolling feature to review and/or modify the data. To exit the window, the user presses the Return 
Key. The insert and delete features previously discussed are available on this data table. 


Aero Dispersion Data 


Mach Number Delta Ca Delta Cn Delta cm Altitude Delta Fab 
Index Table Table Table Table Table Table 

(---) (-) (-) (-) (ft) db) 


1 

2 


25 


Figure 8-13. Aerodynamic Dispersion Data Menu 


Table 8-9. Aerodynamic Dispersion Data 


Parameter 

Description 

Units 

Mach Number Table 

Mach number independent table for 
aerodynamic dispersion coefficients 

— 

Delta Ca Table 

Incremental value of axial force coefficient 

... 

Delta Cn Table 

Incremental value of normal force 
coefficient 

... 

Delta Cm Thble 

Incremental value of pitching moment 
coefficient 

... 

Altitude Table 

Altitude independent table for base force 
dispersion table 

ft | 

Delta Fab Table 

Incremental axial base force 

lb 
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9. ATTITUDE CONTROL 


If the user selects the "Attitude Control" item in the main menu, the submenu shown in 
Figure 9-1 is displayed. This submenu requires the user to select either the first stage (or pre-min-H 
attitude control) or the upper stage (or the min-H phase). The user chooses an item from this submenu 
by moving the cursor, via the up and down Arrow Keys, to the desired selection and pressing the 
Return Key. The user is returned to the submenu after exiting the selection. To return to the main 
menu, the user must select the "Return to Main Menu" item and press the Return Key. The items in 
the submenu are discussed in the next subsections. 


Attitude Control 


First Stage (pre-Min-H) 
Second Stage or Min-H Phase 
Return to Main Menu 


Figure 9-1. Attitude Control Menu 


9.1 FIRST STAGE (PRE-MIN-H) 

If the ’’First Stage (pre Min-H)” item is selected on the ’’Attitude Control” submenu, the 
submenu shown in Figure 9-2 is displayed. This submenu displays the various attitude options that 
are available for the first stage or pre min-H attitude control. The user chooses an item from this 
submenu by moving the cursor, via the up and down Arrow Keys, to the desired selection and pressing 
the Return Key. The following paragraphs define how the user reviews and/or modifies the attitude 
control options. 


Types of Attitude Control 


Chip & Chiy vs Time/Rel Vel 
Angle of Attack vs Mach 
Alt Att vs Rel Mach 
Q-Alpha 

Polynomial Attitude 


Figure 9-2. First-Stage Attitude Control Options Menu 


9-1 



9.1.1 Time or Relative Velocity Dependent Pitch and Yaw Attitude 

If the "chip & chiy vs time/rel vel" item is selected from the "Types of Attitude Control" 
submenu, the user is requested to define the independent parameter through the selection of time or 
relative velocity from the submenu shown in Figure 9-3. The data tables following this submenu, as 
shown in Figures 9-4 and 9-5, display the chosen independent parameter and the attitude angles. 
Table 9-1 provides the definitions of the parameters defined in these figures. As shown in Figures 
9-4 and 9-5, a matrix of data is displayed with the columns representing the parameters and the rows 
representing each of the data items (maximum of 25 data items). Data can be changed by the user 
using the up, down, left, and right Arrow Keys to move the cursor to the desired parameter, pressing 
the Select Key, keying in the changed value, and pressing the Return Key. Due to the number of data 
items exceeding the window size, the user can utilize the scrolling feature to review and/or modify the 
data. To exit the window, the user presses the Return Key. 


Select Indep Parameter 


Time From Lift-Off 
Relative Velocity 

Figure 9-3. Independent Parameter Selection 
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Attitude Control 


Index 


Rel Vel Chip 

Table Table 

(ft/s) (deg) 


Chiy 

Table 

(deg) 


1 

2 

• 

25 


Figure 9-5. Attitude Control (Relative 
Velocity Referenced) Menu 


Table 9-1. Time or Relative Velocity Attitude Data 


Parameter 

Description 

Units 

Time Table 

Time from lift-off independent table 

s 

Rel Vel Table 

Relative velocity independent table 

ft/s 

Chip Table 

Pitch attitude angle in plumbline coordinate system 

deg 

Chiy Table 

Yaw attitude angle in plumbline coordinate system 

deg 


If the user wishes to either delete or add a data item row, the user should place the cursor, 
via the Arrow Keys, over any element of the desired row. Using the Remove Key, the selected row will 
be deleted and all subsequent rows will be moved up. Using the Insert Here Key, the selected row will 
move down along with the subsequent rows. The selected row will display zero values that can be 
modified by the user. 

9.1.2 AOA and Sideslip Angle Attitude 

Attitude parameters associated with AOA and sideslip angle attitude data are defined in this 
subsection. Figure 9-6 provides a display of the parameters, and Table 9-2 provides the definitions 
of the parameters under this subsection. As shown in Figure 9-6, a matrix of data is displayed with 
the columns representing the parameters and the rows representing each of the data items (maximum 
of 25 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to 
move the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and 
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pressing the Return Key. Due to the number of data items exceeding the window size, the user can 
utilize the scrolling feature to review and/or modify the data. To exit the window, the user presses the 
Return Key. The insert and delete features previously discussed are available on this data table. 


Attitude Control 


Mach Number Angle of Attack Sideslip Angle 
Index Table Table Table 

(*■•) (deg) (deg) 

1 

2 

• 

25 


Figure 9*6, AOA Sideslip Attitude Control Menu 


Table 9*2, AOA and Sideslip Angle Attitude Data 


Parameter 

Description 

Units 

Mach Number Ikble 
Angle of Attack Tbble 
Sideslip Angle Tbble 

Mach number independent table 
Angle of attack 
Sideslip angle 

deg 

deg 


9*1*3 Alternate Attitude Angles 

Attitude parameters associated with alternate attitude control data are defined in this 
subsection. Figure 9-7 provides a display of the parameters, and Table 9-3 provides the definitions 
of the parameters under this subsection. As shown in Figure 9-7, a matrix of data is displayed with 
the columns representing the parameters and the rows representing each of the data items (maximum 
of 25 data items). Data can be changed by the user using the up, down, left, and right Arrow Keys to 
move the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and 
pressing the Return Key. Due to the number of data items exceeding the window size, the user can 
utilize the scrolling feature to review and/or modify the data. To exit the window, the user presses the 
Return Key. The insert and delete features previously discussed are available on this data table. 
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Attitude Control 


Rel Vel Pitch 
Index Table Table 
(ft/s) (deg) 


Yaw Time Roll 
Table Table Table 
(deg) (s) (deg) 


1 

2 


25 


Figure 9-7. Alternate Attitude Control Menu 


Table 9-3. Alternate Attitude Control Data 


Parameter 

Description 

Units 

Rel Vel Table 

Relative velocity independent table 

ft/s 

Pitch Table 

Pitch attitude angle 

deg 

Yaw Thble 

Yaw attitude angle 

deg 

Time Table 

Time from lift-off independent table 

s 

Roll Table 

Roll attitude angle 

deg 


9.1.4 Constant Q-Alpha Attitude 

The parameter associated with constant Q-alpha attitude data is defined in this subsection. 
Figure 9-8 provides a display of the input Q-alpha parameter, and Table 9-4 provides the definition 
of the parameter under this subsection. As shown in Figure 9-8, data is displayed next to the 
definition of the parameter. Data can be changed by the user by pressing the Select Key, keying in the 
changed value, and pressing the Return Key. To exit the window, the user presses the Return Key. 


Q-Alpha Attitude 


Abs Value of Q-AJpha (psf-deg) — 

9-8. Q-Alpha Attitude Menu 
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Table 9-4. Q- Alpha Attitude Data 


Parameter 

Description 

Units 

Abs Value of Q-alpha 

Value of Q-alpha 

psf-deg 


9.1.5 Polynomial Attitude 

Attitude parameters associated with polynomial attitude control data are defined in this 
subsection. Figure 9-9 provides a display of the parameters, and Table 9-5 provides the definitions 
of the parameters under this subsection. As shown in Figure 9-9, data is displayed next to the 
parameter definitions. Data can be changed by the user using the up and down Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. To exit the window, the user presses the Return Key. The insert and delete features 
previously discussed are not used on this data table. 


Polynomial Attitude 


Order of First Pitch Polynomial 
Order of First Yaw Polynomial 
Order of Second Pitch Polynomial 
Order of Second Yaw Polynomial 
Thrust Event to Begin Second Polynomial 


Figure 9-9. Polynomial Attitude Menu 


Table 9-5. Polynomial Attitude Data 


Parameter 

Description 

Units 

Order of first pitch polynomial 

Order of first pitch polynomial equation 
(used for tilt over maneuver) 

— 

Order of first yaw polynomial 

Order of first yaw polynomial equation 
(used for tilt over maneuver) 

— 

Order of second pitch 
polynomial 

Order of second pitch polynomial equation 

— 

Order of second yaw polynomial 

Order of second yaw polynomial equation 

— 

Thrust event to begin second 
polynomial 

Thrust event index to begin use of second 
polynomial equations 

— 
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SECOND STAGE OR MIN-H PHASE 


9.2 

If the "Second Stage or Min-H Phase" item of the "Attitude Control" submenu is selected, the 
submenu shown in Figure 9-10 is displayed. This submenu is used to setup the input for the min-H 
portion of the simulation. The data input under the "Control Phase Data" item of the submenu is used 
to define the parameters associated with the one to seven available control phases. Once these 
parameters are defined, the initial angles associated with each control phase are then defined under 
the "Attitude Table Phase 1" through "Attitude Table Phase 7" items of the submenu. Once the 
selected item is exited, the user is returned to the submenu. To return to the "Attitude Control” 
submenu, the "Return to Previous Menu" item should be selected. 


Attitude Control 


Control Phase Data 
Attitude Table Phase 1 
Attitude Table Phase 2 
Attitude Table Phase 3 
Attitude Table Phase 4 
Attitude Table Phase 5 
Attitude Table Phase 6 
Attitude Table Phase 7 
Return to Previous Menu 


Figure 9-10. Min-H Attitude Control Menu 


9.2.1 Control Phase Data 

Attitude parameters associated with min-H phase attitude control data are defined in this 
subsection. Figure 9-11 provides a display of the parameters, and Table 9-6 provides the definitions 
of the parameters under this subsection. As shown in Figure 9-11, data are displayed next to the 
parameter definitions. Data can be changed by the user using the up and down Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. To exit the window, the user presses the Return Key. The insert and delete features 
previously discussed are not used on this data table. 
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Phase Control Options 


Phase Number 1 2 3 4 5 6 7 

Thrust Event Where Phase Begins 

Thrust Event Where Phase Ends 

Number of Data Points Per Table 

Pitch Only (1), Pitch and Yaw (2) 


Figure 9-11. Min-H Phase Control Parameters Menu 


Table 9-6. Min-H Control Phase Data 


Parameter 

Description 

Units 

Thrust event 
where phase begins 

Index of thrust event where min-H 
attitude phase begins 

... 

Thrust event 
where phase ends 

Index of thrust event where min-H 
attitude phase ends 

— 

Number of data 
points per table 

Number of data points per min-H 
attitude phase 

... 

Pitch only (1), 
pitch and yaw (2) 

Attitude angle selection option per 
phase; 1 - pitch attitude only; 

2 - pitch and yaw attitude 

— 


9.2.2 Attitude Table Data 

Attitude angle and time parameters associated with min-H attitude control table data are 
defined in this subsection. Figure 9-12 provides a generic display of the parameters associated with 
the seven attitude phases, and Table 9-7 provides the definitions of the parameters under this 
subsection. As shown in Figure 9-12, a matrix of data is displayed with the columns representing the 
parameters and the rows representing each of the data items (maximum of 30 data items). Data can 
be changed by the user using the up, down, left, and right Arrow Keys to move the cursor to the desired 
parameter, pressing the Select Key, keying in the changed value, and pressing the Return Key. Due 
to the number of data items exceeding the window size, the user can utilize the scrolling feature to 
review and/or modify the data. To exit the window, the user presses the Return Key. The insert and 
delete features previously discussed are available on this data table. 
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Attitude Phase No i 


Time 

Index Table 

(s) 


Chip Chiy 

Table Table 

(deg) (deg) 


1 

2 

• 

30 

Figure 9-12. Min-H Attitude Control Table Menu 


Table 9-7, Min-H Attitude Angle Data 


Parameter 

Description 

Units 

Time Table 
Chip Table 
Chiy Table 

Time from lift-off 

Pitch attitude angle Plumbline coordinate system 
Yaw attitude angle Plumbline coordinate system 

s 

deg 

deg 
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10. MASS PROPERTIES 


If the user selects the "Mass Properties" item in the main menu, the submenu shown in 
Figure 10-1 is displayed. This submenu allows the user to choose the manner in which mass 
properties will be calculated in the MASTRE Program. The first option uses the tabular data that 
defines axial and normal CG as a function of weight overboard. The second option uses inputs 
generated by separate mass properties program to allow a dynamic calculation of axial and normal CG. 
The user interface program for the mass properties program is discussed in Appendix A. 


Mass Properties Options 


Use Tabular Data 
Use Preprocessor Data 
Return to Main Menu 

Figure 10-1. Mass Properties Submenu 

The user chooses an item from this submenu by moving the cursor, via the up and down 
Arrow Keys, to the desired selection and pressing the Return Key. The user is returned to the submenu 
after exiting the selection. To return to the main menu, the user must select the "Return to Main 
Menu" item and press the Return Key. 

Parameters associated with the mass properties tabular data are defined in this section. 
Figure 10-2 provides a display of the parameters while, and Table 10-1 provides the definitions of the 
parameters. A matrix of data, as shown in Figure 10-2, is displayed with the columns representing 
the parameters and the rows representing each of the data items (maximum of 15 data items). Data 
can be changed by the user using the up, down, left, and right Arrow Keys to move the cursor to the 
desired parameter, pressing the Select Key, keying in the changed value, and pressing the Return Key. 
To exit the window, the user presses the Return Key. 
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Mass Properties 


Delta Wt Delta Wt Long CG Long CG Vert CG Vert CG 

1st Stage 2nd Stage 1st Stage 2nd Stage 1st Stage 2nd Staee 

(lbm) Obm) (m) (m) (m) (m) 

xxxx.x 

xxxx.x 

• 

xxxx.x 


Figure 10-2. Mass Properties Data Menu 


Table 10-1 . Mass Properties Data 


Parameter 

Description 

Units 

Delta Wt. 1st Stage 

First stage weight overboard 
independent for CG tables 

lb 

Delta Wt. 2nd Stage 

Second stage weight overboard 
independent for CG tables 

lb 

Long CG 1st Stage 

First stage longitudinal CG 

ft 

Long CG 2nd Stage 

Second stage longitudinal CG 

ft 

Vert CG 1st Stage 

First stage vertical CG 

ft 

Vert CG 2nd Stage 

Second stage vertical CG 

ft 


If the user wishes to either delete or add a data item row, the user should place the cursor, 
via the Arrow Keys, over any element of the desired row. Using the Remove Key, the selected row will 
be deleted and all subsequent rows will be moved up. Using the Insert Here Key, the selected row will 
move down along with the subsequent rows. The selected row will display zero values that can be 
modified by the user. 


10-2 







11. ENVIRONME NTAL DATA 


If the user selects the "Environmental Data" item in the main menu, the submenu shown in 
Figure 11-1 is displayed. This submenu allows the user to select the atmospheric and wind models to 
be used in the MASTRE simulation. The user chooses an item from this submenu by moving the 
cursor, via the up and down Arrow Keys, to the desired selection and pressing the Return Key. The 
user is returned to the submenu after exiting the selection. To return to the main menu, the user must 
select the "Return to Main Menu" item and press the Return Key. The items in the submenu are 
discussed in the next subsections. 


Environmental Data 


Atmospheric Selection 
Wind Data 

Return to Main Menu 

Figure 11-1 . Environmental Data Menu 


11.1 ATMOSPHERIC SELECTION 

The names of the seven atmospheric models shown in Figure 11-2 are displayed when the 
user selects the "Atmospheric Selection" item of the "Environmental Data submenu. The cursor 
designation when this submenu appears indicates the current selection made in the MASTRE input 
file. The user selects from this submenu by moving the cursor, via the up and down Arrow Keys, to the 
desired item and pressing the Return Key. If the Range Reference item is selected, the user is also 
required to select the reference month from the bar shown in Figure 11-2. 

Regardless of the selection from the "Atmospheric Selection” submenu, the name of the 
selected atmospheric model will appear in the lower portion of the window, as shown in Figure 11-2. 

11.2 WIND DATA 

The names of the five wind models shown in Figure 11-3 are displayed as the "Wind 
Options" submenu when the user selects the "Wind Data item of the Environmental Data submenu. 
The cursor designation when this submenu appears indicates the current selection made in the 
MASTRE input file. 
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Atmospheric Models 


Range Reference 
Patrick Reference 
Vandenburg Reference 
Patrick (Hot) 

Patrick (Cold) 
Vandenburg (Hot) 
Vandenburg (Cold) 


Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec 


Range Reference 


Figure 11-2. Atmospheric Models Menu 


Wind Options 


User Wind Tables 
Mean Annual Winds 
Annual Enveloping Winds 
Monthly Winds - ETR 
Monthly Winds - WTR 
No Winds 

Return to Previous Menu 


■ — — — 1 

1' — - — - — 

Jan Feb Mar Apr May Jun Jul Aug 

Sep Oct Nov Dec 


Monthly Winds - ETR 



Figure 11-8. Wind Options Menu 
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If the "User Wind Tables" item is selected from the ’Wind Options" submenu, the data tables 
shown in Figure 11-4 are displayed. Table 11-1 defines the parameters associated with this 
submenu. A matrix of data, as shown in Figure 11-4, is displayed with the columns representing the 
parameters and the rows representing each of the data items (maximum of 100 data items). Data can 
be changed by the user using the up, down, left, and right Arrow Keys to move the cursor to the desired 
parameter, pressing the Select Key, keying in the changed value, and pressing the Return Key. Due 
to the number of data items exceeding the window size, the user can utilize the scrolling feature to 
review and/or modify the data. To exit the window, the user presses the Return Key. 


User Wind Data 


Altitude Speed Azimuth 

Index Table Table Table 
(ft) (ft/s) (deg) 


1 

2 


100 


Figure 11-4. User Wind Data Menu 


Table 11-1. User Wind Data 


Parameter 

Description 

Units 

Altitude Thble 
Speed Table 
Azimuth Thble 

Altitude independent table 
Wind speed 

Wind direction measured clockwise from North 

ft 

ft/s 

deg 


If the user wishes to either delete or add a data item row, the user should place the cursor, 
via the Arrow Keys, over any element of the desired row. Using the Remove Key, the selected row will 
be deleted and all subsequent rows will be moved up. Using the Insert Here Key, the selected row will 
move down along with the subsequent rows. The selected row will display zero values which can be 
modified by the user. 
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If either the "Monthly Winds - ETR" or "Monthly Winds - WTR" items are chosen from the 
Wind Options" submenu, the user must also select the desired month from the bar shown in Figure 

11 - 3 . 

Regardless of the selection from the 'Wind Options" submenu, the name of the selected wind 
model will appear in the lower portion of the window, as shown in Figure 11-3. After each selection 
is exited, the user is returned to the 'Wind Options" submenu. To return to the "Environmental Data” 
submenu, the user must select the "Return to Previous Menu" item and press the Return Key. 
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12. CONSTANTS 


If the user selects the "Constants" item in the main menu, the submenu shown in 
Figure 12-1 is displayed. This submenu allows the user to select the Earth model, integration, and 
optimization constants that are used in the simulation. The user chooses an item from this submenu 
by moving the cursor, via the up and down Arrow Keys, to the desired selection and pressing the 
Return Key. The user is returned to the submenu after exiting the selection. To return to the main 
menu, the user must select the "Return to Main Menu item and press the Return Key. The items in 
the sub menu are discussed in the next subsection. 


Constants 


Earth Model Constants 
Integration Constants 
Optimization Constants 
Return to Main Menu 


Figure 12-1, Constants Menu 


12.1 EARTH MODEL CONSTANTS 

Parameters associated with Earth model constant data are defined in this subsection. 
Figure 12-2 provides a display of the parameters, and Table 12-1 provides the definitions of the 
parameters under this subsection. As shown in Figure 12-2 , data are displayed next to the parameter 
definitions. Data are read only and cannot be changed by the user. To exit the window, the user 
presses the Return Key. 
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Constants - Read Only 


1st Coef Fischer Elpsd Gr. Expn ( — ) 

2nd Coef Fischer Elpsd Gr. Expn ( — ) 

3rd Coef Fischer Elpsd Gr. Expn ( — ) 
Flattening Coef Fischer Model (...) 

Earth Mass * Univ Grav Constant (m 3 /s 2 
Grav Acc of Earth at Equator (m/s 2 ) 

Angular Rotational Vel of Earth (rad/s) 
lb/f 2 to N/m 2 Conversion ( — ) 

lb Mass to kg Conversion ( — ) 

Radius of Earth at the Equator (m) 


Figure 12-2. Earth Model Constants Menu 


Table 12-1 . Earth Model Constants Data 


Parameter 


Description 


Units 


1st Coef Fischer Elpsd 
Gr. Expn 

2nd Coef Fischer 
Elpsd Gr. Expn 

3rd Coef Fischer Elpsd 
Gr. Expn 

Flattening Coef 
Fischer Model 

Earth Mass * Univ 
Grav Constant 

Grav Acc of Earth at 
Equator 

Angular Rotational 
Vel of Earth 

lb/ft 2 to N/m 2 
Conversion 

lb Mass to kg 
Conversion 

Radius of Earth at the 
Equator 


First coefficient in the Fischer ellipsoid 
gravitational expansion 

Second coefficient in the Fischer ellipsoid 
gravitational expansion 

Third coefficient in the Fischer ellipsoid 
gravitational expansion 

Flattening coefficient of the Fischer Model 


Product of the universal gravitational constant | m 3 /s 2 

and the mass of the earth 

Gravitational acceleration of the earth at the | m/s 2 
equator 

Angular rotational velocity of the earth | rad/s 

Conversion from lb/ft 2 to N/m 2 
Conversion from pounds mass to kilograms 
Radius of the earth at the equator I m 
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INTEGRATION CONSTANTS 


Parameters associated with integration constant data are defined in this subsection. Figure 
12-3 provides a display of the parameters, and Table 12-2 provides the definitions of the parameters 
under this subsection. As shown in Figure 12-3, data are displayed next to the parameter definitions. 
Additional help to the user is provided, as shown in Figure 12-3, when either the forward or backward 
integration method item of the submenu is selected. Data can be changed by the user using the up and 
down Arrow Keys to move the cursor to the desired parameter, pressing the Select Key, keying in the 
changed value, and pressing the Return Key. To exit the window, the user presses the Return Key. 
The insert and delete features previously discussed are not used on this data table. 


Integration Constants 


Integration Method 

-forward 

Integration Method 

- backward 

Integration Order of Differences 

- forward 

- backward 

Min Step Size 

- forward 

- backward 

Smallest Value of Dep Var for Step 

- forward 

- backward 

Upper Limit for Step Size Control 

- forward 

- backward 


Integration Types 

1 - Variable Step Adams-Moulton 

2 - Fixed Step Runge-Kutta 

3 - Fixed Step Adams Predictor Only 


Figure 12-3. Integration Constanta Menu 
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Table 12-2. Integration Constanta Data 


Parameter 

Description 

Units 

Integration Method 

Integration method indicator 

1 - variable step size Adams-Moulton 

2 - fixed step Runge-Kutta 

3 - fixed step Adams-Predicator only 


Integration Order of 
Differences 

Order of differences used in the 
integration scheme when using 
variable step size integration 

— 

Min Step Size 

Minimum step size for integration 


Smallest Value of Dep 
Var for Step 

Smallest value of dependent variable 
for step size control 

... 

Upper Limit for Step 
Size Control 

Upper bound on integration step size 
control algorithm 

— 


12.3 OPTIMIZATION CONSTANTS 

Parameters associated with optimization constant data are defined in this subsection. 
Figure 12-4 provides a display of the parameters, and Table 12-3 provides the definitions of the 
parameters under this subsection. As shown in Figure 12-4, data are displayed next to the parameter 
definitions. Data can be changed by the user using the up and down Arrow Keys to move the cursor to 
the desired parameter, pressing the Select Key, keying in the changed value, and pressing the Return 
Key. To exit the window, the user presses the Return Key. The insert and delete features previously 
discussed are not used on this data table. 


Optimization Constants 


Maximize (1) or Minimize (-1) 1.0 

Constraint Step Size 0.25 

Optimality Step Size 0.80 

Convergence Tolerance 0.005 


Increment for Pitch Att Partial 0.1 
Increment for Yaw Att Partial 0. 1 


Figure 12-4. Optimization Constants Menu 
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Table 12-3. Optimization Constants Data 


Parameter 

Description 

Units 

Maximize (1) or Minimize (-1) 

This parameter declares that the payoff 
function will be either maximized (with a 
value of 1) or minimized (with a value of -1) 

... 

Constraint Step Size 

Decimal fraction of constraint error to 
remove on first iteration (if initial guesses 
are known to be good, a value of 1 will 
speed convergence) 

... 

Optimality Step Size 

Decimal fraction of optimization step used 
during the optimization process 

... 

Convergence Tblerance 

Convergence tolerance on the value of the 
| normalized total derivatives of the payoff 
with respect to the parameters (output as 
"NEW PCON") 

— 

Increment for Pitch Attitude 
Partial 

Value of incremental pitch attitude angle 
used to determine forward difference 
partial derivative for first-stage pitch 
attitude parameters (non-mi n-H) 

deg 

Increment for Yaw Attitude 
Partial 

Value of incremental yaw attitude angle 
used to determine forward difference 
partial derivative for first-stage yaw 
attitude parameters (non-min-H) 

deg 
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13. OPERATIONAL OPTIONS 


If the user selects the "Operational Options" item in the main menu, the submenu shown in 
Figure 13-1 is displayed. This submenu allows the user to select operational options that are used in 
the simulation. The user chooses an item from this submenu by moving the cursor, via the up and 
down Arrow Keys, to the desired selection and pressing the Return Key. The user is returned to the 
submenu after exiting the selection. To return to the main menu, the user must select the "Return to 
Main Menu" item and press the Return Key. The items in the submenu are discussed in the next 
subsections. 


Operational Options 


Terminal Constraints 
Intermediate Constraints 
Operating Variables 
Times 
Jump Start 
Special Options 
Return to Previous Menu 


Figure 13-1 . Operational Options Menu 


13.1 TERMINAL CONSTRAINTS 

Selecting the "Terminal Constraints" item on the "Operational Options" submenu allows the 
user to select and quantify the terminal constraints that are applied at the end of the forward 
trajectory. The display shown in Figure 13-2 is used to define the payoff function that is to be 
maximized or minimized as well as the terminal conditions that are to be satisfied. The types of 
parameters are specified by the user placing constraint codes under the "Constraint Code" header of 
Figure 13-2. The codes are obtained from the "Constraint Code Reference" column of Figure 13-2. 
The first parameter under the "Constraint Code" header is considered the payoff, or optimization, 
function. The values of the other parameters are defined next to the constraint codes under the 
"Constraint Value" header. Data are changed for either the codes or values by moving the cursor (via 
the up, down, right, and left Arrow Keys), pressing the Select Key keying in the desired data, and 
pressing the Return Key. To exit this window, the user presses the Return Key. 
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Constraint Code Reference 

<==Constraint Code 

Constraint Value 

1 - Cutoff Weight (lb) 

i 

<-- Optimization 

2 - Inertial Velocity (m/s) 

2 

xxxx.xx 

3 - Inertial Flight Path Angle (deg) 

3 

x.xxxxx 

4 - Radius (m) 

4 

xxxxxxxx. 

5 - Altitude (Oblate Earth) (m) 

10 

xx.xxxx 

6 - Not Used at This Time 

- 

_ 

7 - Earth Fixed Velocity (m/s) 

- 

- 

8 - Earth Rel Heading Angle (deg) 

- 

- 

9 - Earth Rel Fit-Path Angle (deg) 

- 

- 

10 - Inclination (deg) 

- 

- 

11 - Inert Descending Node (deg) 



12 - Not Used at This Time 



13 - Not Used at This Time 



14 - Orbital Velocity (m/s) 



15 - Max Dynamic Pressure (psi) 



16 - Stag Heating Indicator (BTU) 

Terminal constraints 

17 - RTLS Term Condition (m/s) 

Hit select to change 

18 - RTLS Init Condition (m/s) 

Arrow keys to move 

19 - Range from Launch Site (nm) 




Figure 13-2. Terminal Constraints Selection Menu 


13.2 INTERMEDIATE CONSTRAINTS 

Selecting the "Intermediate Constraints" item on the "Operational Options" submenu allows 
the user to select and quantify the intermediate constraints that are applied at the end of specified 
thrust events during the forward trajectoiy. The display shown in Figure 13-3 is used to define the 
specified thrust event as well as the intermediate conditions that are to be satisfied. The types of 
parameters are specified by the user placing constraint codes under the "Constraint Code" header of 
Figure 13-3. The codes are obtained from the "Constraint Code Reference" column of Figure 13-3. 
The values of the parameters are defined next to the constraint codes under the "Constraint Value" 
header. 

The user is first requested to define the index number of the thrust event where the 
intermediate constraint will be imposed. To modify the current value, the user presses the Select Key, 
keys in the desired index number, and presses the Return Key. Whether modifying the data or not, 
pressing the Return Key displays the codes and values and moves the cursor to the newly displayed 
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items. Data are changed for either the codes or values by moving the cursor (via the up, down, right, 
and left Arrow Keys), pressing the Select Key, keying in the desired data, and pressing the Return Key. 


Select Optimization Parameters 


Constraint Code Reference <==Constraint Code Constraint Value 

1 - Cutoff Weight (lb) 5 xxxxxx. 

2 - Inertial Velocity (m/s) 

3 - Inertial Flight-Path Angle (deg) 

4 - Radius (m) 

5 - Altitude (Oblate Earth) (m) 

6 - Not Used at This Time 

7 - Earth Fixed Velocity (m/s) 

8 - Earth Rel Heading Angle (deg) 

9 - Earth Rel Fit-Path Angle (deg) 

10 - Inclination Angle (deg) 

11 - Inert Descending Node (deg) 

12 - Not Used at This Time 

13 - Not Used at This Time 

14 - Orbital Velocity (m/s) 

15 - Max Dynamic Pressure (psi) 

16 - Stag Heating Indicator (BTU) 

17 - RTLS Term Condition (m/s) 

18 - RTLS Init Condition (m/s) 

19 - Range from Launch Site (nm) 

Figure 13-3. Intermediate Constraints Selection Menu I 

Since there can be up to five intermediate constraints imposed, the user may select either the 
Next Scrn or Prev Scm Keys to transfer from one intermediate constraint window to another. The 
index number of the intermediate constraint window is shown in Figure 13-3 to the right of the "#" 
sign. To return to the "Operational Options" submenu, the user presses the Return Key once if the 
codes and values are displayed and twice if the codes and values are not displayed. 

13.3 OPERATING VARIABLES 

Parameters associated with operating variable data are defined in this subsection. 
Figure 13-4 provides a display of the parameters, and Table 13-1 provides the definitions of the 
parameters under this subsection. As shown in Figure 13-4 , data are displayed next to the parameter 
definitions. Additional help to the user, as shown in Figure 13-4 , is displayed when either the 


Termination Thrust Event #14 

Intermediate constraints are imposed 

after this event, if the value is 0, 

constraints are not imposed 

Hit Select to change 

Next Screen for next consts 

Prev Screen for prev consts 
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"Printout Option" or "Vehicle Orientation" items of the data are selected. Data can be changed by the 
user using the up and down Arrow Keys to move the cursor to the desired parameter, pressing the 
Select Key, keying in the changed value, and pressing the Return Key. To exit the window, the user 
presses the Return Key. The insert and delete features previously discussed are not used on this data 
table. 


Operating Variables 


Thrust event to begin min-H 
Printout option 

Maximum number of iterations 
Vehicle orientation 
Thrust event to begin MPS TVC 
Roll rate for 1st maneuver 
Mach number to begin heads-down 
Roll rate for 2nd maneuver 


Output Options 


0 - Minimum output - 1st and last traj printed 

1 - 1st and last traj printed with optimation 

data tables printed on all iterations 

2 - Maximum output - all iterations are printed 


Orientation Options 


0 - Heads-up 

1 - Heads-down 


Figure 13-4. Operating Variable Menu 
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Table 13-1. Operating Variable Constants 


Parameter 

Description 

Units 

Thrust Event to Begin 
min-H 

Thrust event to begin first min-H attitude phase 

— 

Printout Option 

Printout option 

0 - Minimum output - first and last trajectories 

printed 

1 - First and last trajectories printed with 

optimization data tables printed on all 
iterations 

2 - Maximum output - all iterations are printed 


Maximum Number of 
Iterations 

Maximum number of iterations 

— 

Vehicle Orientation 

Vehicle orientation option 
0 - heads-up, 1 - heads-down 

— 

Thrust Event to Begin 
MPS TVC 

Thrust event number of begin MPS thrust vector 
control (TVC) 

— 

Roll Rate for 1st 
Maneuver 

Roll rate for lst-stage roll maneuver 

deg/s 

Mach Number to Begin 
Heads-Down 

Mach number to begin heads down maneuver 

— 

Roll Rate for 2nd 
Maneuver 

Roll rate for 2nd roll maneuver during upper 
stage 

deg/s 


13.4 TIMES 

Parameters associated with time data are defined in this subsection. Figure 13-5 provides 
a display of the parameters, and Table 13-2 provides the definitions of the parameters under this 
subsection. As shown in Figure 13-5, data are displayed next to the parameter definitions. Data can 
be changed by the user by the up and down Arrow Keys to move the cursor to the desired parameter, 
pressing the Select Key, keying in the changed value, and pressing the Return Key. To exit the 
window, the user presses the Return Key. The insert and delete features previously discussed are not 
used on this data table. 
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Operating Variables 


Time to Begin Tiltover 
Time to End Tiltover 
Time to Begin Roll Maneuver 
Time Between Lift-Off & GRR ~ 


Figure 13-5. Operating Variable - Times Menu 


Table 13-2. Time Variables 


Parameter 

Description 

Units 

Time to begin tiltover 

Time that signifies the end of the lift-off and 
the beginning of the attitude control program 

s 

Time to end tiltover 

Time that signifies the end of the lift-off 
phase 

s 

Time to begin roll 
maneuver 

Time that signifies the beginning of the 
rolling maneuver, which rolls the tail fin from 
initial azimuth into the flight plane in a 
heads-up or heads-down position. 
Termination of the rolling maneuver is 
calculated by dividing the roll angle required 
by the roll rate. 

s 

Time between lift-off 
and GRR 

Time from ground reference release (GRR) to 
lift-off. GRR is the point in the countdown at 
which the launch inertial coordinate system 
is established. 



13.6 JUMP START 

Selecting the "Jump Start" item of the "Operational Options" submenu displays the sub 
menu shown in Figure 13-6. This submenu allows the user to select whether first-stage or upper stage 
jump-start is required. If the user selects the first-stage jump-start, jump-start conditions are stored 
as an output file (specified in the command file) based on the input times defined on the inputs 
provided on the first-stage jump-start data table. If the upper-stage jump-start item is selected, the 
jump-start is activated on the current simulation. The next subsections define the parameters 
associated with the jump-start options. 
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Jump Start Options 


First-Stage Jump-Start 
Upper-Stage Jump-Start 


Figure 13-6. Jump-Start Options Menu 


13.5.1 First-Stage Jump-Start 

Parameters associated with first-stage jump-start data are defined in this subsection. 
Figure 23-7 provides a display of the parameters, and Table 13-3 provides the definitions of the 
parameters under this subsection. As shown in Figure 13-7 , data are displayed next to the parameter 
definitions. Data can be changed by the user by the up and down Arrow Keys to move the cursor to the 
desired parameter, pressing the Select Key, keying in the changed value, and pressing the Return Key. 
To exit the window, the user presses the Return Key. The insert and delete features previously 
discussed are not used on this data table. 


Jump Start Variables 


Number of Thrt Evnt to Begin Simulation 1 

1st Time to Save State for 1st Stg Jump-Start 
2nd Time to Save State for 1st Stg Jump-Start — 
3rd Time to Save State for 1st Stg Jump-Start 
4th Time to Save State for 1st Stg Jump-Start 
5th Time to Save State for 1st Stg Jump-Start 


Figure 13-7. Jump-Start Variables Menu 
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Table 13-3. First-Stage Jump-Start Data 


Parameter 

Description 

Units 

Number of Thrust Event 
to Begin Simulation 

Index number of thrust 
event to begin simulation 

— 

1st Time to Save State for 
1st Stage Jump-Start 

First time to save state 
for first-stage jump-start 

s 

2nd Time to Save State for 
1st Stage Jump-Start 

Second time to save state 
for first-stage jump-start 

s 

3rd Time to Save State for 
1st Stage Jump-start 

Third time to save state 
for first-stage jump-start 

s 

4th Time to Save State for 
1st Stage Jump-Start 

Fourth time to save state 
for first-stage jump-start 

s 

5th Time to Save State for 
1st Stage Jump-Start 

Fifth time to save state 
for first-stage jump-start 

s 


13.5.2 Upper-Stage Jump-Start 

Parameters associated with upper-stage jump-start data are defined in this subsection. 
Figure 13-8 provides a display of the parameters, and Table 13-4 provides the definitions of the 
parameters under this subsection. As shown in Figure 13-8, data are displayed next to the parameter 
definitions. Data can be changed by the user using the up and down Arrow Keys to move the cursor to 
the desired parameter, pressing the Select Key, keying in the changed value, and pressing the Return 
Key. To exit the window, the user presses the Return Key. The insert and delete features previously 
discussed are not used on this data table. 
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Jump Start Variables 


Number of Thrt Evnt to Begin Simulation 
w - Velocity Component (ft/s) 
u - Velocity Component (ft/s) 
v - Position Component (ft/s) 
x - Position Component (ft) 
y - Position Component (ft) 
z - Position Component (ft) 

MPS Propellant Mass (lb) 

SRM Propellant Mass (lb) 

LBM Propellant Mass (lb) 

OMS Propellant Mass (lb) 

RCS Propellant Mass (lb) 

Fixed MPS Propellant Mass (lb) 
Stagnation Heating (BTU) 

Ideal Velocity (ft/s) 

Back Pressure Loss (ft/s) 

Gimbal Loss (ft/s) 

Gravity Loss (ft/s) 

Turning Loss (ft/s) 

Aerodynamic Loss (ft/s) 

Q penalty Function (psf) 

Dump Mass (lb) 

Not Used 
Not Used 
Not Used 


Figure 13-8. Upper-Stage Jump-Start Input Menu 
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Table 13-4. Upper-Stage Jump-Start Data 


Parameter 

Description 

Units 

Number of Thrust Event to 
Begin Simulation 

Number of thrust event to begin 
simulation (>1 for upper-stage jump-start) 

... 

w - Velocity Component 

x velocity component of inertial plumbline 
coordinate system 

m/s 

u - Velocity Component 

y velocity component of inertial plumbline 
coordinate system 

m/s 

v - Velocity Component 

z velocity component of inertial plumbline 
coordinate system 

m/s 

x - Position Component 

x position component of inertial plumbline 
coordinate system 

m 

y - Position Component 

y position component of inertial plumbline 
coordinate system 

m 

z - Position Component 

z position component of inertial plumbline 
coordinate system 

m 

MPS Propellant Mass 

Propellant mass of MPS 

lb 

SRM Propellant Mass 

Propellant mass of SRM propulsion system 

lb 

LBM Propellant Mass 

Propellant mass of LBM propulsion system 

lb 

OMS Propellant Mass 

Propellant mass of OMS 

lb 

RCS Propellant Mass 

Propellant mass of RCS 

lb 

Fixed MPS Propellant 

Propellant mass of fixed MPS mass 

lb 

Stagnation Heating 

Stagnation heating indicator 

BTU/ft 2 

Ideal Velocity 

Ideal velocity 

m/s 

Back Pressure Loss 

Back pressure loss 

m/s 

Gimbal Loss 

Gimbal loss 

m/s 

Gravity Loss 

Gravity loss 

m/s 

Turning Loss 

Turning loss 

m/s 

Aerodynamic Loss 

Aerodynamic loss 

m/s 

Q Penalty Function 

Dynamic pressure penalty function 

psf 

Dump Mass 

Propellant mass of OMS/RCS interconnect 
system 

lb 


13.6 SPECIAL OPTIONS 

There are several special options that are available to the user. Figure 13-9 provides a 
display of the submenu of the special option topics. The user selects one of these topics by using the 
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up and down cursor Arrow Keys and pressing the Return Key. The following paragraphs explain the 
options inputs. 


Operational Options 


Branch Trajectory Option 
Moment Balance Option 
Q-max Constraint Parameters 
Post Coast Option 
Return to Previous Menu 


Figure 13-9. Operational Options Menu 


13.6.1 Branch Trajectory Option 

Parameters associated with the branch trajectory option data are defined in this subsection. 
Figure 13-10 provides a display of the parameters, and Table 13-5 provides the definitions of the 
parameters under this subsection. As shown in Figure 13-10 , data are displayed next to the 
parameter definitions. Data can be changed by the user using the up and down Arrow Keys to move 
the cursor to the desired parameter, pressing the Select Key, keying in the changed value, and pressing 
the Return Key. When moving the cursor, help menus, as shown in Figure 13-10 , are displayed for 
each of the data items. To exit the window, the user presses the Return Key. The insert and delete 
features previously discussed are not used on this data table. 
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Branch Traj Variables 


1st Thrt Event to Save State 
2nd Thrt Event to Save Stage 
Stage to Use State for Branch 
Number of Saved State to be Used -- 


This variable denotes that state variables be 
saved at the beginning of the designated thrust 
event to initialize the branch trajectory. The 2 
values allow 2 thrust events to be saved 


This variable defines which stage will use the 
stored state (designated as the branch segment) 


This variable indicates which stored state will be 
used to initialize the branch trajectory portion of 
the simulation 

Figure 23-10. Branch Trajectory Variables Menu 


Table 23-5. Branch Trajectory Option Data 


Parameter 

Description 

Units 

1st Thrt Event to 
Save State 

Index of thrust event that the state variables at the end of 
the thrust event will be stored for simulation of a later 
portion of the branch trajectory 


2nd Thrt Event to 
Save State 

Index of thrust event that the state variables at the end of 
the thrust event will be stored for simulation of a later 
portion of the branch trajectory 


Stage to Use State 
for Branch 

Index number used to indicate the stage where the stored 
state will be used for initialization 

— 

Number of Saved 
State to be Used 

Index defining which stored state will be used (i.e., 1 or 2) 

— 


13*6.2 MOMENT BALANCE OPTION 

The moment balance option allows the user to select whether the engines are considered to 
be fixed during the simulation or controllable based on zeroing the total aerodynamic and thrust 
moments. If the user selects this item, the user is asked to select from the menu shown in 
Figure 23-22. The user responds by placing the cursor over the desired option and pressing the 
Return Key. The user is then returned to the special options submenu. 
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Moment Balance Option 


Point Mass Trajectory 
Moment Balanced Trajectory 

Figure 13-11. Moment Balance Option Menu 


13.6.3 Q-Max Constraint Parameters 

Parameters associated with Q-max constraint parameter data are defined in this subsection 
(see Figure 13-12 for Q-max option menu). Figure 13-13 provides a display of the parameters, and 
Table 13-6 provides the definitions of the parameters under this subsection. As shown in 
Figure 13-13, data are displayed next to the parameter definitions. Data can be changed by the user 
using the up and down Arrow Keys to move the cursor to the desired parameter, pressing the Select 
Key, keying in the changed value, and pressing the Return Key. To exit the window, the user presses 
the Return Key. The insert and delete features previously discussed are not used on this data table. 


Qmax Option 


Update Throttle Tables 
Variables 

Return to Previous Menu 
Figure 13-12. Q-Max Option Menu 


Qmax Variables 


Index in Throt Table to Begin Throt Down 
Maximum Rate of Throttle 
Time after Max Q to Throttle Up 
Value of Max Q for Penalty Function (psf) 

Figure 13-13. Q-Max Variables Menu 
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Table 13-6. Q-Max Variable Data 


Parameter 

Description 

Units 

Index in throttle table to begin 
throt down 

Index number of MPS throttle table 
used to indicate where the throttle- 
down maneuver begins 

... 

Maximum rate of throttle 

Maximum rate of throttle for 
throttle-up or throttle-down 
maneuvers 

/s 

Time after Q-max to throttle up 

Time interval after maximum 
dynamic pressure to throttle-up 

s 

Value of Q-max for penalty 
function 

Value of maximum dynamic 
pressure used to calculate penalty 
function (currently not used) 

psf 


13.6.4 Post Coast Option 

The post coast option allows the simulation to generate a coast trajectory after the last thrust 
event on the converged trajectory. The display, as shown in Figure 13-14, provides the necessary 
input for this option, which is the index number of the thrust event. The option is activated by a 
nonzero value for this index number. If this option is used, the user must also supply the time interval 
for this event under thrust event related data (see Section 4). 


Coast Phase 


Number of Thro Evnt Used for Coast 


Figure 13-14. Coast Phase Variable Menu 
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14. OPTIMIZATION DATA 


If the user selects the “Optimization Data” item in the main menu, the data table shown in 
Figure 14-1 is displayed. This data table allows the user to select the optimization parameters that 
will be used in the simulation. These parameters have either a value of zero or one. A zero value means 
that the parameter is not optimized; a value of one means that the parameter will be optimized during 
the simulation. The user chooses an item from this submenu by moving the cursor, via the up and down 
Arrow Keys, to the desired selection, pressing the Select Key, keying in the desired value, and pressing 
the Return Key. To exit to the main menu, the user must press the Return Key. 


14-1 



Enter 1 (Active) or 0 (Inactive) 


1st Thr Evnt Duration Time 

0 

2nd Thr Evnt Duration Time 

0 

3rd Thr Evnt Duration Time 

0 

4th Thr Evnt Duration Time 

0 

5th Thr Evnt Duration Time 

0 

6th Thr Evnt Duration Time 

0 

7th Thr Evnt Duration Time 

0 

8th Thr Evnt Duration Time 

0 

9th Thr Evnt Duration Time 

0 

10th Thr Evnt Duration Time 

0 

11th Thr Evnt Duration Time 

0 

12th Thr Evnt Duration Time 

0 

13th Thr Evnt Duration Time 

0 

14th Thr Evnt Duration Time 

0 

15th Thr Evnt Duration Time 

0 

Liftoff Weight 

0 

Launch Azimuth 

0 

1st Value of Pitch Att Table 

0 

2nd Value of Pitch Att Table 

0 

3rd Value of Pitch Att Table 

0 

4th Value of Pitch Att Table 

0 

5th Value of Pitch Att Table 

0 

6th Value of Pitch Att Table 

0 

7th Value of Pitch Att Table 

0 

1st Value of Yaw Att Table 

0 

2nd Value of Yaw Att Table 

0 

3rd Value of Yaw Att Table 

0 

4th Value of Yaw Att Table 

0 

Time to Begin Throttle (Q-max) 

0 

Time Past Q-max to Throttle Up 

0 

Value to Ramp Throttle 

0 


Figure 14-1. Optimization Parameters Menu 
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15. OUTPUT OPTIONS 


If the user selects the "Output Options" item in the main menu, the submenu shown in 
Figure 15-1 is displayed. This submenu allows the user to select output options that are used in the 
simulation. The user chooses an item from this submenu by moving the cursor, via the up and down 
Arrow Keys, to the desired selection and pressing the Return Key. The user is returned to the submenu 
after exiting the selection. To return to the main menu, the user must select the Return to Main 
Menu" item and press the Return Key. The items in the submenu are discussed in the next paragraphs. 


Output Summary Table Options 


Weight Summary Tables 
Parameter Summary Tables 
Propulsion Summary Tables 
Return to Previous Menu 

Figure 15-1. Output Summary Table Options Menu 


16.1 WEIGHT SUMMARY TABLES 

The weight summary tables provide detailed weight breakdowns of the inert weights, burned 
and residual propellant weights, dry weights, and payload associated with the vehicle that the user is 
simulating. Therefore, the weights associated with the weight summary tables are dependent on the 
vehicle system defined when the user first enters the User Interface Program. The weight summary 
tables are output at the end of the simulation run and provide the user with valuable information 
concerning the distribution of weight as well as the final payload. 

The menu, shown in Figure 15-2, displays the options available to the user. Since input for 
the weight summary tables is provided in a separate Namelist file, the user can either use data from 
an existing file or build the data table. If the "Load Weight Namelist" options is used, the user is first 
prompted to define the directory/subdirectory and the file name. A system search is used to find all files 
with a ".wnl" extension, and the user is required to select one. The selection is done by moving the 
cursor with the up, down, right, and left Arrow Keys to the desired file name and pressing the Return 
Key. If no files are found during the search, the user will be prompted "There are no files with that 
extension! Look for another extension? (y/n)". If the user responds with a ”Y" or "y", an additional 
prompt "enter ext" will be displayed asking the user to define the new three character extension. The 
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user may also define a new directory/subdirectory. A new search will take place after this. If the user 
responds with a “N” or “n”, the search is terminated and no data are loaded and all values are zeroed. 


Weight Output Options 


Load Weight Namelist 
Review/Modify Data 
Return to Main Menu 

Figure 15-2. Weight Output Options Menu 

Depending on the system that the user is simulating, the data shown in either Figure 15-3 
for the Multistage Liquid Vehicle System, Figure 15-4 for the Multistage SRB Vehicle System, or 
Figure 15-5 for the Space Shuttle will be displayed if the “Review/Modify Data” selection is made. If 
a branch trajectory is being simulated, there will be two sets of numerical data that correspond to each 
data item; otherwise, one set of numerical data will be present. The user can modify these data by using 
the up, down, right, and left Arrows Keys to move the cursor to the selected data, pressing the Select 
Key, keying the new data, and pressing the Return Key. To exit, the user presses the Return Key. Upon 
exiting, the user is asked if the updated data are to be saved. If the answer is yes, the user is prompted 
to supply a new file name. If the answer is no, the updated data will not be stored. After either 
response, the user is then returned to the “Output Options” submenu. 


15-2 





Upper Stage - Inert Structure 

- Flight Performance Reserve 

- Delta Velocity reqd (fps) 

- Specific Impulse (sec) 

- Fuel Bias 

- Prop Residuals/Unusables 
Performance Margin - Payload 

- Other 

2nd Stage - Stage Inert Weight (less eng) 

- Nonpropulsive Consumables 

- Dry Weight of Engine(s) 

- Prop Residuals/Unusables 

- Flight Performance Reserve 

- Fuel Bias 

- MPS Thrust Buildup 

- Boiloff, Overfill, Drainback 
Shroud - Weight separated at MECO 

- Jettison Weight 

1st Stage - Stage Inert Weight (less eng) 

- Dry Weight of Engine(s) 

- Nonpropulsive Consumables 

- Fuel bias 

- Prop Residuals/Unusables 

- MPS Thrust Buildup 

- Boiloff, Overfill, Drainback 

Figure 15 3 . Multistage Liquid Vehicle Weight Summary Inputs 



Upper Stage - Inert Structure 

- Flight Performance Reserve 

- Delta Velocity reqd (fps) 

- Specific Impulse (sec) 

- Fuel Bias 

- Prop Residuals/Unusables 
Performance Margin - Payload 

- Other 

2nd Stage - Stage Inert Weight (less eng) 

- Nonpropulsive Consumables 

- Dry Weight of Engine (s) 

- Prop Residuals/Unusables 

- Flight Performance Reserve 

- Fuel Bias 

- MPS Thrust Buildup 

- Boiloff, Overfill, Drainback 
Shroud - Weight separated at MECO 

- Jettison Weight 

1st Stage - Stage Inert Weight (less eng) 

- Dry Weight of Engine(s) 

- Nonpropulsive Consumables 

- Fuel bias 

- Prop Residuals/Unusables 
Strap-on - Inert Motor Weight (less eng) 

- Dry Weight of Engine(s) 

- Nonpropulsive Consumables 

- Fuel Bias 

- Prop Residuals/Unusables 

- Inerts Consumed (SRM Only) 

MPS - MPS Thrust Buildup 

- Boiloff, Overfill, Drainback 

Figure 15-4. Multistage SHE Vehicle Weight Summary Inputs 
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Mission Kit 
OMS Kit 

Orbiter - Empty 

- Nonpropulsive Consumables 

- RCS Reserves 

- RCS Residuals 

- OMS Propellant (deorbit) 

- OMS Reserves 

- OMS Residuals 
SSME Empty 

Trapped MPS Propellant - Orbiter 

- SSME 

Flight Performance Reserve - Orbiter 

- SSME 

RCS Propellant - ET Separation 
External Tank - Empty 

* Residuals 

Fuel Bias 

Flight Performance Reserve - ET 
Expelled MPS Propellant 
LBM Inert Weight 
SRM Inert Weight 
SRM Residual Propellant 
Inerts Consumed 
SRB Inerts 

MPS Thrust Buildup + SRM Ignition Delay 
Overfill, Drainback, and Boiloff 
Nonpropulsive Consumables 

Figure 25-5. Space Shuttle Weight Summary Inputs 


15.2 PARAMETER SUMMARY TABLES 

Parameter summary tables are optional tables that are printed at the end of the converged 
trajectory on the FOR021.DAT file. This option provides 14 publishable output tables that show a time 
history of many of the parameters generated by the MASTRE Program. 

Since this is an option to the user, the first display the user sees is a question to determine 
if the user will use this option (see Figure 15-6). If the answer is no, the user is returned to the output 
options submenu. If the answer is yes, the submenu shown in Figure 15-7 is displayed. This submenu 
allows the user to review and modify each of the types of parameters available under each table. The 
user can modify each parameter by placing the cursor at the parameter and pressing the return key. 
A scrollable table of all parameter choices is shown in the lower left part of the screen. The user can 
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now select the parameter by highlighting the selection with the cursor and pressing the return key. If 
a choice of units is available, a table is shown in the lower right part of the screen. The user highlights 
the choice and presses the return key. The table is then updated with the new selection. To exit, the 
user selects “Return to Previous Menu” to return to the output summary tables submenu and selects 
the “Return to Previous Menu” in the tables submenu to return to the options menu. 


Program Options 


Will this options be used (y/n)? ==> 


Figure 15-6. Parameter Summary Option Selection Menu 


Output Summary Tables 


Table No. 1 
Table No. 2 
Table No. 3 
Table No. 4 
Table No. 5 
Table No. 6 
Table No. 7 
Table No. 8 
Table No. 9 
Table No. 10 
Table No. 11 
Table No. 12 
Table No. 13 
Table No. 14 

Return to Previous Menu 


Figure 15-7. Output Summary Tables Menu 


15.3 PROPULSION SUMMARY TABLES 

Propulsion summary tables are optional tables that are printed at the end of the converged 
trajectory on the FOR007.DAT file. This option provides one publishable output table that show a time 
history of propulsion parameters (primarily associated with propellant heights in the tanks) generated 
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by the MASTRE Program. Using this option requires inputting two additional files that are declared 
in the command file (see Section 17). 

Since this is an option to the user, the first display is a question to determine if the user will 
use this option (see Figure 15-8). If the answer is no, the user is returned to the output options 
submenu. If the answer is yes, the data table shown in Figure 15-9 is displayed. This data table shows 
two variables that must be input. To edit the input data, the user selects the data item with the up and 
down cursor Arrow Keys, presses the Select Key, keys in the desired data, and presses the Return Key. 
To exit to the output options submenu, the user presses the Return Key. 






Will this options be used (y/n)? ==> 


Figure 15-8. Propulsion Summary Option Selection Menu 


Program Options 


LOX Residual Propellant - 
LH2 Residual Propellant 

Figure 15-9 . Propellant Summary Inputs Menu 
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16 . DISPERSIONS 


If the user selects the 'Dispersions'* item in the main menu, the submenu shown in 
Figure 16-1 is displayed. This submenu allows the user to select the dispersion options. The first six 
items of this submenu define the type of dispersion tr^ectory that will be simulated, the next item 
defines additional input parameters that must be included to simulate the dispersion runs, the next 
item provides a method for initialization of the dispersion output file, and the last item returns the user 
to the Main Menu. The user chooses an item from this submenu by moving the cursor, via the up and 
down Arrow Keys, to the desired selection and pressing the Return Key. The user is returned to the 
submenu after exiting the selection. To return to the main menu, the user must select the "Return to 
Main Menu" item and press the Return Key. The items in the submenu are discussed in the next 
paragraphs. 


Dispersion Options 


Nominal 

Propulsion 

Aero/Environment 

Mass Properties 

GN&C 

Composite 

Additional Parameters 
Initialize Options Menu 
Return to Main Menu 

Figure 16-1 . Dispersion Options Menu 


If one of the first six items of the submenu is chosen, a series of windows are displayed. If the 
"nominal" item is selected, a lower window displays the selection of the nominal item. If any other item 
of the six items is selected, a window showing the different types of cases under the category selected 
is displayed. The user, using the up and down cursor Arrow Keys, selects the appropriate choice and 
presses the Return Key. After the Return Key is pressed, a lower window displays the selection, and 
another window is used to define whether the run is for a positive or negative dispersion case. The user 
again makes a selection, and the selection is displayed in the lower window. The user is then returned 
to the dispersion submenu. To exit to the Main Menu, the user must select the "Return to Main Menu" 
item of the submenu. 

The next subsections discuss the other items in the submenu. 
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16.1 


ADDITIONAL DISPERSION PARAMETERS 


When simulating dispersion trajectories, it is important to maintain a common time history 
between all runs. The purpose of these additional parameters is to provide inputs that will provide a 
common time history. If the "Additional Parameters" item is selected from the submenu, the data table 
shown in Figure 16-2 is displayed. Table 16-1 provides a definition of these parameters. To edit this 
data table, the user uses the up and down cursor Arrow Keys to select the data item, presses the Select 
Key, types in the desired data, and presses the Return Key. To exit to the dispersion submenu, the user 
presses the Return Key. 


Additional Dispersion Inputs 


1st step size used for output file 
2nd step size used for output file 
Time @ which the 2nd step size starts — 

Figure 16-2. Additional Dispersion Inputs Menu 


Table 16-1. Additional Dispersion Parameters 


Parameter 

Description 

1st step size used for 
output file 

2nd step size used for 
output file 

Time @ which the 2nd 
step size starts 

Step size used for print out of dispersion 
output primarily during first stage 

Step size used for print out of dispersion 
output primarily during upper stages 

Time from liftoff to initiate 2nd step size 


16.2 FILE OPTIONS 

A single output file is used in dispersion studies to provide an output storage medium for the 
data. After completing the dispersion runs, the generated output file can be used by the RSS Program 
(see Subsection 2.6.3) to calculate statistical data and to provide plotting output files. When beginning 
a dispersion study, the user must initialize the output file by using either of the options shown in 
Figure 16-3. (WARNING: Initialization of the output file after starting the study will erase 
all previous data from the file.) The initialization is necessary since the output is a direct access 
file that has an unique format. As shown in Figure 16-3, the user can either create a new file or 
reinitialize an old file. If a new file is desired, the user is prompted to define a director/subdirectory 
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and a file name, and the initialization process begins. If an old file is to be reinitialized, the program 
searches for all files in the current directory with a ".DSP" extension. Once these files are found, the 
list of files is displayed and the user can select from the list. The selection is made using the up, down, 
left, and right cursor Arrow Keys to select the desired file name and pressing the Return Key. After 
the selection is made, the reinitialization process is performed. 


File Options 


Initialize New/File 
Reinitialize Existing File 
Return to Previous Menu 

Figure 16-3. Dispersion File Options Menu 

If no files are found during the search, the user will be prompted "There are no files with 
that extension! Look for another extension? (y/n)." If the user responds with a "Y” or "y", an 
additional prompt "enter ext" will be displayed asking the user to define the new three-character 
extension. The user may also define a new directory/subdirectory. A new search will take place after 
this. If the user responds with a "N" or "n", the search is terminated and the user is returned to the file 
option submenu. 
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17. COMMAND FILES 


If the user selects the "Command Files" item in the main menu, the submenu shown in 
Figure 17-1 is displayed. This submenu allows the user to either build a new command file, edit an 
old command file, or return to the main menu. The user chooses an item from this submenu by moving 
the cursor, via the up and down Arrow Keys, to the desired selection and pressing the Return Key. The 
user is returned to the submenu after exiting the selection. To return to the main menu, the user must 
select the “Return to Main menu” item and press the Return Key. The items in the submenu are 
discussed in the next subsections. 


Select 


Build a New Command File 
Edit an Old Command File 
Return to Main Menu 


Figure 17-2. Command File Option Menu 


17.1 BUILDING A NEW COMMAND FILE 

If the user wishes to build a command file, the "Built a new command file" item on the 
submenu is selected, which results in the display shown in Figure 17-2. This display shows three 
windows: "Select," "Build," and "Data Input." To build a new command file, the user responds in the 
"Data Input" window, to the requests listed in Table 17-1. These requests are used to define the input 
and output files that are used by the MASTRE Program. When the user responds, the records of the 
new command file are displayed one-by-one in the "Build" window. The "Data Input" window also 
provides response information for the user. The user has a choice of responding in either of three ways: 
the Return Key can be pressed, which defaults to the characters provided within the brackets shown 
on the request; the Select Key can be pressed and the appropriate file name can be typed in; or the Find 
Key can be pressed, which searches for all files in the current directory with the same extension, prints 
the list of files in the "Select" window, and allows the user to pick from this list. If the Find Key is used, 
the desired file name can be selected by moving the cursor, via the Arrow Keys, to the file name in the 
"Select" window and pressing the Return Key. The selected file name is then placed in the new 
command file in the "Build" window. If no files are found during the search, a message is displayed and 
a blank record is placed in the command file. If this happens, the user must modify the command file 
record (by using the Select Key) to account for the blank record. 
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SELECT 


SELECT 


$write sys$output "com file" 

$run [ mastre. work]mastre 

yes 

yes 

2 

2 

no 

aerol5.anl 

mis2branch.wnl 

no 

mis2branch.ini 

no 

1 

0 

1 


Data Input 


Enter title for this com file [com file] ==> 

Press=> RETURN for [default]. FINQ to select file SELECT to enter data 
Figure 1 7 - 2 . Build Command File Work Menu 


After entering the optional title of the command file, the user will notice that several records 
are output on the command file as default values (see Subsection 2.6.5 for definitions of these records). 
If the user wishes to edit these default values, the build process must be complete, the new command 
file must be saved, and the "Edit an old command file" option must be selected. 

If a request has a default value with an asterisk followed by an extension, the user can either 
use the Select Key to type in the file name or use the Find Key to activate a search for files with the 
same extension. The Find Key allows the user to select the desired file name from the list of available 
files. 


For consistency checking, input flags are checked if a particular file is requested. If the 
internal input flags (from the input file defined at the initiation of the User Interface Program) are not 
consistent with the files being defined in the command file (i.e., an output file that has not been 
requested), one of three events will occur. Either an error message is displayed to the user and nothing 
is done, the input flags are changed to reflect the command file, or the input flag is changed based on 
additional information supplied by the user. If the user tries to insert either a first-stage jump-start 
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input or output file into the command file and the input does not include provisions for a first-stage 
jump-start (i.e., a lift-off time that is nonzero and corresponding to a time on the input file or the 
omission of a first-stage jump-start time used to generate the output file) an error message will be 
displayed and no action will be taken. If the user includes an alternate mass properties file or LOX and 
LH2 input files and internal flags have not been set, these flags will be set. If the dispersion file is 
included and the user has not provided a dispersion flag (i.e., the IVAR variable discussed in 
Subsection 2.6.3), the program will allow the user to define this input flag through a series of menus 
in the "Select" window. These menus, which define the types of dispersion cases, are shown in Figure 
27-3. If the dispersion file is included, the user must also supply additional information that is provided 
in Subsection 16.1, as well as initializing the file as discussed in Subsection 16.2. 

Table 27-2. Computer Requests to Build Command File 

Enter title for this comfile [comfile] 

Enter name of nonlinear aero data base [none] 

Enter aero data Namelist file [*.anl] 

Enter weight Namelist file [*.wnl] 

Enter SRM data file [none] 

Enter trajectory Namelist file [*.inl] 

Enter alternate mass prop file [none] 

Enter name of output plot file [none] 

Enter name of dispersion data file [none] 

Enter first-stage jump-start input file [none] 

Enter first- stage jump-start output file [none] 

Enter LOX table input file [none] 

Enter LH2 table input file [none] 

Printout menu [none] 

Terminate [yes] 

17.2 EDITING AN OLD COMMAND FILE 

If the user wishes to review or edit an existing command file, the ’’Edit an old command file” 
item on the submenu is selected, which results in the display shown in Figure 17-4, This display also 
shows three windows: ’’Build,” ’’Select,” and ’’Edit Functions." After displaying these windows, the 
computer searches the user-defined directory for existing command files (i.e., those with a .COM 
extension) and lists the file names in the "Select" window. The user selects from this list by moving the 
cursor to the appropriate file name and pressing the Return Key. The command file is then displayed 
in the "Build" window, and the cursor is placed on the first record of the file. The up and down Arrow 
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Keys can then be used to move the cursor to the other records of the file. If the number of records of the 
file exceeds the size of the window, the user can scroll to the hidden records by moving the cursor to 
the top or bottom of the window and continue pressing the Arrow Key. 



Figure 17-3. Dispersion Type Selections 


The function of the Edit Functions window is to provide editing information for the user. 
The user has a choice of four editing options. An entry can be changed by using the Select Key. This 
works in the same manner as changing data in many of the menus. A line of minus signs is displayed, 
which signifies that the user must type in the appropriate data and press the Return Key. 

The second and third options allow the user to either delete or insert a record in the command 
file by using the Remove Key or Insert Here Key, respectively. 

If the record is a file name, the fourth option allows the user to use the Find Key to find all 
file names in the current directory with the same extension. The list of file names is displayed in the 
"Select" window, and the user is required to select one of the file names. A file name is selected by 
moving the cursor to the desired file name and pressing the Return Key. The selected file name then 
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replaces the file name in the "Build" window. During the search, if no files are found, a message is 
displayed and no action is taken. 


SELECT 


BUILD 


$write sys$output "com file" 
$run [mastre.workjmastre 
yes 
yes 
2 
2 

no 

aerolS.anl 

mis2branch.wnl 

no 

mis2branch.ini 

no 

1 

0 

1 


Edit Functions 


Press=> RETURN to quit FIND to select file SELECT to enter data 

INSERT to insert data REMOVE to delete data 


Figure 17-4. Build Command File Work Menu 


To terminate editing, the user presses the Return Key. The user will then be asked to provide 
a name for the edited command file. If the user does not want to save the edited command file, the 
Return Key must be immediately hit. 
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18. PLOT OUTPUT 


If the user requests the MASTRE Program, via the command file, to generate a plot file 
(using a .PLT extension), the "Plot Output" item of the main menu can be selected after the MASTRE 
Program has been executed. The plot option allows the user to generate XY plots of user-selected 
parameters. The first screen, as shown in Figure 18-1, displays the four types of plotting devices that 
can be utilized. However, the user is currently restricted to the Terminal option. After selecting this 
option, the main plot menu shown in Figure 18-2 is displayed. This menu provides seven options to 
the user. The "File" option allows the user to select the directory/subdirectory and the file name of the 
trajectory file to be printed. After selection of the file name, the menus shown in Figurel8-3 are used 
to define the X and Y variables to be plotted. These variables replicate the variables in the trajectory 
block printout shown in Section 19. The user can use the up, down, left, and right Cursor Arrow Keys 
to high-light the variable name and press the Return Key. The definitions of the variable mnemonics 
used in this menu are also defined in Section 19. After pressing the Return Key, the variable name is 
displayed above the selection chart as shown in Figure 18-3. After selecting both the X and Y 
variables, the user is asked to verify his selection. If the selection is correct, the program reads the 
trajectory files, writes a plot file, and displays the number of points and the minimum and maximum 
of both X and Y variables (see Figure 18-4). 


HP Plotter^^HColor Tek^HMonochr Tck^^HTerminal 


Figure 18-1 . Plotting Devices 


Setu 


n 


Data^HPlot 


nflTTTO l [f lTTTi 


Figure 18-2. Plotting Main Menu 

The "File" option is to be used only when the user wishes to define and initially read the 
trajectory file. Otherwise, the "Data" option can be selected. The "Data" option performs the same 
functions as the "File" option except that it does not allow the user to define the trajectory file. 

The "Setup" option allows the user to choose between automatic and manual scaling (see 
Figure 18-5). If automatic scaling is selected, the user is returned to the main plot menu. If manual 
scaling is selected, a series of menus, as shown in Figure 18-6, are displayed to scale the X and Y 
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variables based on the user-specified chart size, the maximum and minimum data displayed, and tic 
mark spacing. The user is also asked for requirements for log scale and grid lines. 


x-axis is TIME 


Select X Variable 


TUB VSUBE GAME AZE THRST XMLB R VSUBI GAMI AZI 

GCLAT LONG ALT VSUBR GAMR AZR GDLAT NODE Z8-X X8-Y 

Y8-Z ZD8-W XD8-U YD8-V CHIP CHIY CHIR TIMP LTIMP LNGMP 

THER PSIR PHIR INCL RANGE RNGAN THMPS THSRM THLBM THOMS 


x-axis is TIME y-axis is ALT 
Is this correct ? (y,n) 


|Select Y Variable! 


TOfflB VSUBE GAME AZE THRST XMLB R VSUBI GAMI AZI 

GCLAT LONG ALT VSUBR GAMR AZR GDLAT NODE Z8-X X8-Y 

Y8-Z ZD8-W XD8-U YD8-V CHIP CHIY CHIR TIMP LTIMP LNGMP 

THER PSIR PHIR INCL RANGE RNGAN THMPS THSRM THLBM THOMS 


Please wait - Reading the file 


Figure 18-3. Variable Selection Menu 





- 

242 Points came across from 
X-values ranged from 
Y- values ranged from 

file BRA 
0.00 
-23.75 

N CH_PLOT.PLT: ! 
to 486.81 
to 502506.00 


Figure 18-4. Data Summary 
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** Labels ** 


x-axis default TIME y-axis default ALT 

Type new labels or return for defaults 
Enter x-axis label => 

Enter y-axis label => 


Figure 18 - 6 . Scaling Menus (Concluded) 
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The "Axes" option is currently not available under the terminal option. The "Change" option 
allows the user to change plotting devices. However, since the terminal option is the only one available, 
the "Change" option is not applicable. 

The "Plot" option plots the variables to the terminal screen. The user can clear the screen and 
return to the main plot menu by pressing the Return Key. 

The plot output is terminated by selecting the "Quit” option. 
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19 . MASTRE PROGRAM OUT PUT DESCRIPTION 


The output for the MASTRE Program is described in this section. The output is divided into 
the following groups: initial output, trajectory block output, iteration output, and post processor 
output. The initial output, trajectory block output, and the iteration output are contained in the 
FOR031.DAT output file. Portions of the post processor output are contained in the FOR031.DAT, 
FOR021.DAT, and FOR007.DAT output files. The following subsections present examples of these 
output printouts, describe the variables defined within, and define which output medium is used for 
output. 

19.1 INITIAL OUTPUT 

Initial output is printed on the FOR031.DAT file and is used to output the input variables 
from the general and aerodynamic Namelist files ($INPUT and $AEROIN, respectively). This output 
describes the current status of these variables in memory. The first output is a function of whether 
nonlinear aerodynamics are being simulated. If nonlinear aerodynamics are being simulated, multiple 
aerodynamic tabular data consisting of the axial, normal, and yaw force coefficients and the pitching, 
yawing, and rolling moment coefficients are output; otherwise, these tables are omitted. A tabular 
listing of the linear aerodynamic coefficients versus Mach number follows the nonlinear data or is the 
first output if nonlinear aerodynamics are not simulated. This output is followed by tabular data of 
base force data versus altitude, which is followed by tabular data of wind speed and direction versus 
altitude. 

The aerodynamic Namelist data, under the name $AEROIN, are the next data to printed. 
The variable names associated with the inputs are equated with the input data. The general trajectory 
Namelist data, under the name $INPUT, are printed next. In a multiple run job, one consisting of more 
than one trajectory simulation, the aerodynamic Namelist will only appear on the first trajectory 
simulation (the assumption is that the aerodynamic data will not change when in a multiple-run 
mode). 

19.2 TRAJECTORY BLOCK OUTPUT 

Parameters associated with the equations of motion, as well as other pertinent data, are 
printed in the trajectory block output. Printing of the block output occurs whenever the user requests 
that the trajectory be printed. The usual mode is for the trajectory printout to occur on the first (or 
nominal) and converged trajectories. The printing of the block output occurs when describing discrete 
events (i.e., staging, thrust event initiation, maximum dynamic pressure) or when the print interval 
requires a printout. A page of output, as shown in Figure 19-1, consists of two blocks of print. The 
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Figure 19-1. Trajectory Block Printout 



caption at the upper left hand comer of the block identifies the significance of the particular printout 
(the caption “LIFT OFF” in the example printout). If a caption is not shown, either a print interval has 
been completed or a thrust event has been terminated. Discrete events are described by the captions 
shown in Table 19-1. 


Table 19-1. Discrete Event Descriptions 


Captions 

Description 

IGNITION 

Initiation of the trajectory from the launch site or 
jump-start conditions 

LIFT-OFF 

Initial movement of the vehicle from the launch site 
when total acceleration, less gravity, is equal to one 

THRUST EVENT 

Beginning of a thrust event 

BEGIN COAST 

Beginning of a coast thrust event 

END COAST 

Coast thrust event termination 

BEGIN TILT 

Beginning of tilt-over maneuver 

END TILT 

Tilt-over maneuver termination 

SRB SEPARATION 

Separation of the SRBs 

BEGIN MIN-H 

Min-H attitude control has been initiated 

LBM IGNITION 

Begin simulation of LBM engines 

LBM SEPARATION 

Separation of the LBM 

MAX DYN PRESS 

Maximum dynamic pressure 

BEGIN ROLL 

Begin initial roll maneuver to place the vehicle pitch 
plane in the flight plane 

END ROLL 

End roll maneuver 

BEGIN CHIFRZ 

Begin pitch attitude freeze 

CORE SEPARATION 

Core stage separation 

SEPARATION 

1 

Stage separation 

INTERMEDIATE 

Intermediate constraint 

SHROUD JETTISON 

Jettison of the shroud 

G-LIMIT 

Begin throttle to either maintain or reduce 
acceleration after hitting the limit 

MPS THROTTLE 

Discrete changes in the main propulsion system 
throttle history 

WEIGHT DROP 

Weight drop event 

INJECTION 

Trajectory termination 


The block printout, as shown in Figure 19-1, consists of 24 lines of output. The variables are 
defined in Table 19-2. 
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Print 

Variable 

Line 1 

TIME 

VSUBE 

GAME 

AZE 

THRST 

XMLB 

Line 2 

R 

VSUBI 

GAMI 

AZI 

GCLAT 
LONG 
Line 3 
ALT 
VSUBR 
GAMR 
AZR 
GDLAT 
NODE 
Line 4 
Z8-X 
X8-Y 
Y8-Z 
ZD8-W 
XD8-U 
YD8-V 


Table 19-2. Block Output Variable Descriptions 


Description 


Units 


Time from lift-off 
Earth-fixed velocity 
Earth-fixed flight path angle 
Earth-fixed azimuth angle 
Total vehicle thrust 
Total weight 


s 

fVs 

deg 

deg 

lbf 

lbm 


Radius from Earth’s center 
Inertial velocity 
Inertial flight path angle 
Inertial azimuth 
Geocentric latitude 

Longitude (positive east of Greenwich) 

Altitude above ellipsoid 
Relative velocity 
Relative flight path angle 
Relative azimuth 
Geodetic latitude 
Inertial descending node 


Shuttle 8 Z position coordinate, MASTRE X coordinate 

ft 

Shuttle 8 X position coordinate, MASTRE Y coordinate 

ft 

Shuttle 8 Y position coordinate, MASTRE Z coordinate 

ft 

Shuttle 8 Z velocity coordinate, MASTRE W coordinate 

ft/s 

Shuttle 8 X velocity coordinate, MASTRE U coordinate 

ft/s 

Shuttle 8 Y velocity coordinate, MASTRE V coordinate 

ft/s 


ft 

ft /8 

deg 

deg 

deg 

deg 


ft 

ft/s 

deg 

deg 

deg 

deg 
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Table 19-2. Block Output Variable Descriptions (Continued) 


Print \ 

Variable 

Description 

Units 

Line 5 



CHIP 

Pitch attitude angle 

deg 

CHIY 

Yaw attitude angle 

deg 

CHIR 

Roll attitude angle 

deg 

TIMP 

Time to predicted impact point (if terminated) 

s 

LTIMP 

Geocentric latitude of instantaneous (vacuum) impact 
point 

deg 

LNGMP 

Longitude of instantaneous (vacuum) impact point 

deg 

Line 6 



THERI 

Pitch attitude angle in Boost Reference coordinate 
system 

deg 

PSIRI 

Yaw attitude angle in Boost Reference coordinate 
system 

deg 

PHIRI 

Roll attitude angle in Boost Reference coordinate 
system 

deg 

INCL 

Inclination angle 

deg 

RANGE 

Relative range from the launch site to the vehicle 
subpoint 

nm 


RNGAN Inertial range angle between the launch site and the deg 

vehicle radius vector 

Lines 7 through 14 provide data for all the six propulsion systems; columns 1 through 6 
represent the output of the MPS, SRM, LBM, OMS, RCS, and the fixed MPS, respectively. 


Line 7 
TH 

Total thrust of the propulsion system 

lbf 

Line 8 
TV 

Total vacuum thrust 

Ibf 

Line 9 
ISP_ 

Vacuum specific impulse 

s 

Line 10 
WD 

Propellant flowrate 

lbm/s 

Line 11 
F 

Propellant on board 

lbm 

Line 12 
D 

Depleted propellant 

lbm 






















Table 19-2. Block Output Variable Descriptions (Continued) 


Print 

Variable 

Description 

Units 

Line 12 



DP 

Composite pitch gimbal angle 

deg 

Line 14 



DY 

Composite yaw gimbal angle 

deg 

Line 15 



TAU 

Throttle setting of MPS engines 

... 

YRING 


psi 

PDOME 

LOX bulkhead pressure indicator 

lbffm 2 

SRMET 

SRM-ET shear load indicator 

lbf 

ORBET 

Orbiter-ET attach load indicator 

lbf 

CHVL 

Characteristic velocity 

fl/s 

Line 16 



TNL 

Turning losses 

m/s 

GVL 

Gravity losses 

m/s 

DR L 

Drag losses 

m/s 

BKPL 

Back pressure losses 

m/s 

GIML 

Gimbal losses 

m/s 

ID VL 

T : i n 

Ideal velocity 

m/s 


Line 17 

MACH Mach number 


ALPHA 

BETA 

FAA 

FAS 

FAN 

AOA 

Sideslip angle 
Aerodynamic axial force 
Aerodynamic side force 
Aerodynamic normal force 

deg 

deg 

lbf 

lbf 

lbf 

ne 18 



Q 

Dynamic pressure 

Ibf/ft 2 

QALPH 

Product of Q and AOA 

lbf-deg/ft 2 

QBETA 

Product of Q and sideslip angle 

lbf-deg/ft 2 

FAB 

Axial component of base force 

lbf 

FMB 

Base moment 

lbf-m 

FNB 

Normal component of base force 

lbf 








Table 19 - 2 . Block Output Variable Descriptions (Continued) 


— 

Print 

Variable 

Description 

Units 

— 

Line 19 
DRAG 

Aerodynamic drag force 

lbf 


LIFT 

Aerodynamic lift force 

lbf 

_ 

VWIND 

Wind speed 

ft/s 


AZW 

Wind direction 

deg 


HEAT 

Stagnation heating indicator 

BTU 


HRATE 

Stagnation heating rate 

BTU/s 


Line 20 
PRESS 

Atmospheric pressure 

lb/ft 2 


RHO 

Atmospheric density 

slugs/ft 3 


TEMP 

Atmospheric temperature 

K 


REYNO 

Reynolds number 

— 


DELPC 

Pitch misalignment of total thrust vector due to control 

deg 

— 

DELYC 

Yaw misalignment of total thrust vector due to control 

deg 


Line 21 
EMACH 

Mach number based on Earth -fixed velocity 



INBD 

In -board elevon setting 

deg 


OUTBD 

Out-board elevon setting 

d eg 


AXACC 

Total axial acceleration (less gravity) 

g*s 


NRACC 

Total normal acceleration (less gravity) 

gfs 

— 

LTACC 

Total lateral acceleration (less gravity) 

g’s 


Line 22 
XCG 

! Longitudinal component of CG 

in. 


ZCG 

Normal component of CG 

in. 


OPEN 

Dynamic pressure penalty function 

lbf/ft 2 

— 

HAERO 

Reference altitude for aerodynamics 

ft 


HATMOS 

Reference altitude for atmosphere 

ft 

— 

FOM 

Total acceleration 

g’s 
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Table 19-2. Block Output Variable Descriptions (Concluded) 


Print 

Variable 

Description 

Units 

Line 23 



AMX 

Body X component of aerodynamic moment 

nt-m 

AMY 

Body Y component of aerodynamic moment 

nt-m 

AMZ 

Body Z component of aerodynamic moment 

nt-m 

TMX 

Body X component of thrust moment 

nt-m 

TMY 

Body Y component of thrust moment 

nt-m 

TMZ 

Body Z component of thrust moment 

nt-m 

Line 24 



OLOW 

Orbiter (or second stage) lift-off weight 

lbm 

WINT 

Initial weight of current stage 

lbm 

TBIAS 

Time between current time and internal time (used for 
branch trajectory) 

s 

X ACC 

Plumbline X coordinate acceleration component 

m/s2 

Y ACC 

Plumbline Y coordinate acceleration component 

m/s 2 

Z ACC 

Plumbline Z coordinate acceleration component 

m/s 2 


19.3 ITERATION OUTPUT 

The iteration output follows the trajectory output after each forward and backward 
simulation of the trajectory. The iteration consists of single variables, vectors, matrices, and other 
pertinent data associated with the iteration and optimization process. The amount of printout obtained 
is a function of the printout option described in Subsection 13.3. Table 19-3 lists the outputs obtained 
using the various printout options. As shown in Table 19-3, an index number has been used to specify 
the various formats used in the iteration output. Each of these formats are discussed in the following 
subsections. 

19.3.1 Trajectory Summary Table (Format 1) 

Directly after the simulation of the forward trajectory, a trajectory summary table is printed 
that displays the value of the payoff function and the errors in the terminal and intermediate equality 
constraints for both the present and previous trajectories. Also displayed are the amounts of change 
requested from the algorithm, the amounts of change obtained, and the percentages of predictability. 
A example of the trajectory summary table is shown in Figure 19-2. 
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Table 19-3. Printout Options 


Output Group 

Option 2 

Option 1 

Option 0 

Trajectory Block Output 

All trajectories are printed 
giving discrete point printouts 
on the nonconverged 
trajectories and full printout 
on the converged trajectory. 

Only first and converged 
trajectories are printed, the 
first giving only discrete 
points and the converged 
giving the full printout. 

Same as Option 1 

Iteration Output 

All formats are printed. 
Control variable printout 
consists of all points in control 
table. 

Same as Option 2 except 
control variable printout is 
printed full on the first 
trajectory and first and last 
points thereafter. 

Formats 1, 2, 3, 4, 
10, 12 (treated 
the same as 
Option 1), and 13. 


19.3.2 Polynomial Coefficients Output (Format 2) 

The polynomial coefficients required to define the booster pitch and yaw attitude during the 
tilt-over maneuver are printed as shown in Figure 19-3. 


POLYNOMIAL COEFFICIENTS 

AP 0 . 64018660E-03 0 . 19540985E-01 0 .OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0 . 000000 OOE+OO 
0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0. OOOOOOOOE+OO 
0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 
0 .OOOOOOOOE+OO 0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0. OOOOOOOOE+OO 
AX-0.11176398E-06 0 . 74274085E-04 0 . OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0 , OOOOOOOOE+OO 
0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 
0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0. OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0 . OOOOOOOOE+OO 
0 . OOOOOOOOE+OO 0. OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0 . OOOOOOOOE+OO 0 . OOOOOOOOE+OO 


Figure 19-3. Polynomial Coefficients Table 


19.3.3 Calculus of Variations (COV) Lambdas Output (Format 3) 

The initiation time of the min-H phase is printed along with the seven variable associated 
with the Euler-Lagrangian multipliers of the COVs. These variables, as shown in Figure 19-4, are 
determined, with the exception of time, after the second iteration and are zero prior to this. 

19.3.4 Influence Coefficients Output (Format 4) 

This matrix of output provides the user with the partial derivatives, or influence coefficients, 
of the payoff and the constraints with respect to the optimization parameters. The size of this output 
varies as a function of the number of equality constraints (left-to-right on the page) and the number of 
optimization parameters (top-to-bottom). An example of the influence coefficients printout is shown in 
Figure 19-5. 
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19.3*5 I-PSI-PSI Output (Format 5) 

This output matrix provides the printout of the optimization weighting matrix, Wa, 
presented in the Engineering Manual, which is based on integrated values of the impulse functions. 
The size of this matrix is dependent on the number of equality constraints. An example of this matrix 
is shown in Figure 19-6. 

19.3.6 PSUBI and WIBT Outputs (Format 6) 

The output vectors entitled PSUBI and WIBT provide the elements of the Wb weighting 
matrix described in the Engineering Manual. The PSUBI array is the calculated weighting on each of 
the optimization parameters, and WIBT is the weighting array that is updated by the program to speed 
convergence. The Wb weighting matrix is made up of the products of these two arrays. An example 
output is shown in Figure 19-7. 

19.3.7 Total I-SY-SY Matrix Output (Format 7) 

The total I-SY-SY matrix output, as shown in Figure 19-8, displays the matrix product of 
the influence coefficients and the weighting matrix before inversion of the matrix. The number of 
elements of this matrix is a function of the number of terminal and intermediate constraints. 

19.3.8 WGNU Output (Format 8) 

The WGNU output variable shown in Figure 19-9 is an indicator, or measure, of the overall 

improvement of the payoff function on an iteration-by-iteration process, however, the constraints must 
be small. 

19*3.9 XKAY and El Outputs (Format 9) 

The XKAY and El output variables, as shown in Figure 19-10, are the current values of the 
restoration and optimization step control variables. XKAY, or k, is the restoration control step variable 
and El, or E, is the optimization control step variable. 

19*3.10 DRHO, WDS, and GNU Outputs (Format 10) 

The DRHO, WDS, and GNU output, as shown in Figure 19-11, is a matrix of variables where 
the columns denote the DRHO, WDS, and GNU values and the rows are associated with each of the 
terminal and intermediate constraints. DRHO is defined as the equality constraint errors to be 
addressed by the restoration step, WDS is defined as the product of the inverse of the total ISYSY 
matrix and the DRHO vector, and GNU is defined as the partial derivatives of the payoff with respect 
to each constraint. 
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WGHU 0 . 18806423E+07 


Figure 19-9. WGNU Output Variables 


xkay 0 .250000002+00 El 0 . OOOOOOOOE+OO 

Figure 19-10 . XKAY and El Outputs 


DRHO, WDS, GNU 

0.48356354E+02 0 . 37783469E-01 0 .2310002 5E+02 
-0 . 1091002 9E+00-0 . 15890812E+01-0 . 71956037E+03 
-0 . 51197328E+04 0 . 36864487E-03 0 . 98991634E-01 
0 .52728039E-02 0 . 87507703E+00-0 . 17135260E+03 
-0 .32136723E+04-0 . 10638470E-02 0 . 11568424E-01 
0 . 48006333E+02 0 . 18686029E-01 0 .23396755E+02 
-0 . 47404493E-01-0 . 53390378E+00 0 . 91365492E+02 
-0 . 7261 481 9E+04 Q .12208996E-03 0.53241282E-01 
0 . 11351752E-01 0. 10274 139E+01-0.11176623E+03 
-0 .32805886E+04-0 . 10433235E-02 0 . 16573155E-01 


Figure 19-11 . DRHO, WDS, andGNU Outputs 

19.3.11 Parameter Update and Convergence Test Output (Format 11) 

As shown in Figure 19-12 , the variables defined in Table 19-4 are printed or can be printed 
depending on the user’s choice of optimization parameters. 


DPAR OLD PCON NEW PCON 

AHEWCH I BETCON 1 T 

0 . 12552734E+00 0 . OOOOOOOOE+OO-O .22078328E-02 
AHEWCH I BETCON 2 T 

0.31370607E-03 0. OOOOOOOOE+OO 0 .32069708E-02 
AHEWCH I BETCON 3 T 

0 . 37 650207E+00 0 . OOOOOOOOE+OO-O . 38377839E-03 
AHEWCH I BETCON 4 T 

0 . 1358054 OE+OO 0 . OOOOOOOOE+OO-O . 23667236E-02 
ANEWCH I BETCON 5 T 


P SCALE 
0 . 56222356E+04 
0 . 688063 11E+0 3 
0. 688063 11X+03 
0 . 964 50383E+03 


ANEWCH I BETCON 6 T 

0 . 18332926E+00 0 . OOOOOOOOE+OO 0 . 76257576E-01 
TAUT ( 2>- 0.11872153E+03 
TAUT ( 4)- 0. 850003 14E+02 
TAUT ( 5)- 0.23917150E+03 
TAUT ( 6)- 0 . 75135805E+02 

GOING FALSE ON TAUT DBETA 96.03176681249458 
TAUT ( 7)- 0.96031767E+02 
AFTER 143 BETCON F 
CPTBL F 

CPTBL ( 2) - 0.22612329E+02 


0.20464266E+04 


0.2397668124945776 


Figure 19-12. Parameter Update and Convergence Test Output 


19.3.12 Control Variable Update Output (Format 12) 

The previous and updated values of the control variables (i.e., the pitch and yaw attitude 
angles) and the increments determined by the min-H algorithm are printed in this output, as shown 
in Figure 19-13. These angles and increments are printed in degrees and should be used for the next 
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guess values if the trajectory does not converge. If the output option has a value of either zero or one, 
the complete list of tables is printed after the first trajectory iteration, and a compact list showing only 
the first and last value of each attitude control phase is printed thereafter. If the output option is equal 
to two, the complete list is printed after each iteration. 


Table 19-4. Parameter Update and Convergence Test Variables 


Variable 

Description 

DPAR 

Parameter update requirement (one per optimization parameter) 

OLD PCON 

Convergence factors from previous iteration (one per optimization 
parameter) 

NEW PCON 

Convergence factors for current iteration (one per optimization parameter) 

P SCALE 

Convergence parameter normalization factor (one per optimization 
parameter) 

TAUTCI) 

If the ith thrust event time is being optimized, the updated value is printed 

W01 

If lift-off weight is being optimized, the updated value is printed 

AZ 

If launch azimuth is being optimized, the updated value is printed 

CPTBUI) 

If the ith value of the First stage pitch attitude table is being optimized, the 
updated value is printed 

CYTBLd) 

If the ith value of the First stage yaw attitude table is being optimized, the 
updated value is printed 

THROTTLE PAR (1) 

If MPS throttle-down time is being optimized, the updated value is printed 

THROTTLE PAR (2) 

If time after max Q is being optimized, the updated value is printed 

THROTTLE PAR (3) 

If throttle level is being optimized, the updated value is printed 

SIDESLIP PAR (I) 

If sideslip angles are being optimized, the updated value is printed 


19.3.13 Convergence Indicator Output (Format 13) 

Directly after the control variable update printout is an output that displays the maximum 
increment (or decrement) required (in radians) when updating the pitch and yaw attitude angle tables. 
(An example output is shown in Figure 19-14.) When both of the maximum increment values are less 
than 0.005 and all the other convergence tests are met, the logical word BETCON is output as a T, or 
true, which indicates that convergence has occurred. If BETCON is F, or false, the iteration process 
continues. The fourth word on this line is the parameter KAT, which is used to indicate that an ill- 
conditioned matrix has been encountered during the determination of the Wa weighting matrix in the 
backward trajectory simulation. If KAT is equal to one, which indicates an ill-conditioned matrix, the 
user should terminate the current iterations. When KAT is equal to zero, no problems have been 
encountered. 
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TIME 

0 . 15959602+03 
0.16263172+03 
0.1656674E+03 
0.16870312+03 
0 . 1717309E+O3 
0 . 17477462+03 
0 . 1778103E+03 
0.18084602+03 
0.1838817E+03 
0.18691742+03 
0 . 1899531E+03 
0.19298892+03 
0 . 19602462+03 
0.1990603E+03 
0.2020960E+03 
0.2051317E+03 
0.20816742+03 
0.21120312+03 
0.2142389E+03 
0 .21727 4 6E +03 
0 .2203103E+03 
0.2233460E+03 
0 .2263B17E+03 
0 .22941742+03 
0 .2324531E+03 
0 .2354889E+03 
0.23852 4 6E+03 
0 .2415603E+03 
0 .2445960E+03 
0 .2445960E+03 
0.2531244E+03 
0 .2616528E+03 
0 .2701812E+03 
0 .2787096E+03 
0.2872380E+03 
0 .2957664E+03 
0.3042948E+03 
0 . 3128231E+03 
0.3213515E+03 
0 . 3298799E+03 
0 . 3384083E+03 
0 . 34693672+03 
0.35546512+03 
0 . 3639935E+03 
0 . 3725219E+03 
0 . 3810503E+03 
0.3895787E+03 
0. 398107 1E+03 
0 . 40663552+03 
0 .41516392+03 
0.4236923E+03 
0.4322206E+03 


HEW CP 

0.6798768E+02 
0.6815817E+02 
0 . 6633460E+02 
0.6850862E+02 
0.6B68057E+02 
0.6885101E+02 
0 . 6902019E+02 
0.6918829E+02 
0 . 6935540E+02 
0 . 6952163E+02 
0 . 696B701E+02 
0. 6985158E+02 
0 . 7001536E+02 
0 . 7017837E+02 
0 . 7034062E+02 
0 . 7050213E+02 
0 . 7066290E+02 
0.7082295E+02 
0 . 7098228E+02 
0 . 7114091E+02 
0 . 7129885E+02 
0.714561OE+O2 
0 . 7161267E+02 
0.7176858E+O2 
0 . 7192384E+02 
0 . 7207844E+02 
0.7223241E+02 
0 . 7238576E+02 
0 . 7253B48E+02 
0 . 7254783E+02 
0.7363275E+02 
0 . 7473010E+02 
0 . 7582838E+02 
0 . 7692758E+02 
0.7802763E+02 
0 . 7912852E+02 
0 . 8023021E+02 
0.8133265E+02 
0 . 8243562E+02 
0.8353967E+02 
0 . 8464418E+02 
0 . 0574929E+O2 
0. 86854 98E+02 
0 . 8796120E+02 
0 . 8906792E+02 
0 . 9017510E+02 
0 . 9128271E+02 
0 . 9239069E+02 
0 . 9349902E+O2 
0 . 94 60766E+02 
0.9571656E+02 
0.9682569E+02 


OLD CP 

0 .6458000B+02 0 
0 . 6488109E+02 0 
0. 6519181E+02 0 
0.6550252E+02 0 
0 . 6581324E+02 0 
0 . 6612395E+02 0 
0 . 6643466E+02 0 
0 . 6674538E+02 0 
0 . 6705609E+02 0 
0.6736681E+02 0 
0 . 6767752E+02 0 
0. 6798824E+02 0 
0 . 6829895E+02 0, 
0 . 6860966E+02 0. 
0 . 6892038E+02 0, 
0.6923109E+02 0. 
0 . 6954181E+02 0. 
0.6985252E+02 0. 
0 . 701632 4E+02 0. 
0 . 7047395E+02 0. 
0.7078466E+02 0. 
0 . 7109538E+02 0. 
0 . 7140609E+02 0. 
0 . 7171681E+02 0. 
0 . 7202752E+02 0. 
0 . 7233824E+02 0. 
0 . 7264895E+02 0 
0 . 7295966E+02 0 
0.7327 038E+02 0 
0 . 7328000E+02 0 
0 . 7433788E+02 0 
0 . 7540756E+02 0 
0.7647723E+02 0 
0 . 7754690E+02 0 
0 . 7861657K+02 0 
0 . 7968625E+02 0 
0.8075592E+02 0 
0.8182559E+02 0 
0 . 8289526E+02 0, 
0.8396494E+02 0. 

0 .85034612+02 0. 

0 . 8610428E+02 0. 

0 . 8717395E+02 0. 
0.88243632+02 0. 
0.8931330E+02 0. 

0 . 9038297E+02 0. 
0.9145264E+02 0. 
0 . 9252232E+02 0. 
0.93591992+02 0. 
0.94661662+02 0. 

0 . 9573133E+02 0 
0 .9680101E+02 0 


HEW CY 
.11079442+01 
. 1106866E+O1 
. 1105768E+01 
. 1104700E+01 
1103662E+01 
1102658E+01 
. 1101686E+01 
.1100747E+01 
. 1099841E+01 
. 1098968E+O1 
. 1098129E+01 
. 1097323E+01 
. 1096550E+01 
. 1095810E+01 
. 1095104E+01 
. 1094430E+01 
. 1O93709E+O1 
. 1093182E+01 
. 1092607E+01 
. 1092065E+01 
. 1091557E+01 
. 1091081E+01 
, 1090637E+01 
. 1090227E+01 
1089850E+01 
10895052+01 
10091932+01 
1088914E+01 
108B667E+01 
1088636E+01 
10859342+01 
.10831102+01 
.10802422+01 
.10773312+01 
. 1074377E+01 
.1071379E+01 
. 1068337E+01 
. 1065252E+01 
.10621232+01 
.10589512+01 
.10557352+01 
.10524762+01 
.10491732+01 
.10458262+01 
. 1042437E+01 
.10390042+01 
,10355282+01 
10320092+01 
10284462+01 
102 4 84 IE +01 
1021193E+01 
1017503E+01 


OLD CY 

0.10990002+01 0 
0.10979272+01 0 
0.10960202+01 0 
0 . 10957132+01 0 
0.10946062+01 0 
0.10934992+01 0 
0.10923912+01 0 
0.10912842+01 0 
0.10901772+01 0 
0.10890702+01 0 
0.10879632+01 0 
0.10868562+01 0 
0.10857492+01 0 
0.10846412+01 0 
0.10835342+01 0 
0.10824272+01 0 
0.10813202+01 0 
0.10802132+01 0 
0.10791062+01 0 
0.10779992+01 0, 
0.10768912+01 0. 
0.10757842+01 0. 
0.10746772+01 0. 
0.10735702+01 0, 
0.10724632+01-0 
0.10713562+01-0 
0.10702492+01-0 
0.10691412+01-0 
0.10680342+01-0 
0.10680002+01-0 
0.10604262+01-0 
0.10527682+01-0 
0.10451092+01-0 
0.10374512+01-0, 
0.10297922+01-0, 
0.10221342+01-0, 
0.10144762+01-0, 
0.10068172+01-0. 
0.99915872+00-0. 
0 . 99150032+00-0 . 
0.98384192+00-0. 
0 . 97618352+00-0 - 
0 . 96852512+00-0 
0 . 96086662+00-0 
0 . 95320822+00-0 
0.94554982+00-0 
0.93789142+00-0 
0.93023302+00-0 
0.92257462+00-0, 
0.91491622+00-0, 

0 . 90725782+00-0 . 

0 . 8995994E+00 0. 


DGP 

3407682E+01 
.32770732+01 
.31427932+01 
. 3006101E+01 
.28673292+01 
.2727055E+01 
.2585523E+01 
.2 442906E+01 
. 2299309E+01 
. 2154819E+01 
.2009487E+01 
. 1863346E+01 
.1716412E+01 
.1568707E+01 
. 1420245E+01 
.1271038E+01 
. 1121095E+01 
.97042812+00 
.81904732+00 
.66696252+00 
•5141836E+00 
.36071982+00 
.20658082+00 
.51776232-01 
.10368452+00 
.25979182+00 
.41653632+00 
.57390842+00 
,73189852+00 
.73216522+00 
.70513492+00 
.67745792+00 
.64884272+00 
.61932452+00 
.58893882+00 
.55772152+00 
.52570862+00 
.49293642+00 
.45944152+00 
.42526082+00 
.39043132+00 
.35499042+00 
.31897552+00 
.28242442+00 
.24537532+00 
.20786622+00 
,16993562+00 
,13162232+00 
,92964882-01 
54002522-01 
14774402-01 
2468012E-01 


DCY 

0.89438682-02 1 

0 . 8936889E-02 2 

0 . 8948244E-02 3 

0 . 8986717E-02 4 

0 . 9056697E-02 5 

0.9158995E-02 6 

0 . 9294130E-02 7 

0.94623552-02 8 

0.96638062-02 9 

0. 98984972-02 10 
0.10166402-01 11 
0.10467472-01 12 
0.10801712-01 13 
0.11169072-01 14 
0.11569502-01 15 
0.12002982-01 16 
0.12469502-01 17 
0.12969002-01 18 
0.13501462-01 19 
0.14066862-01 20 
0.14665152-01 21 
0.15296322-01 22 
0.15960342-01 23 
0.16657182-01 24 
0.17386802-01 25 
0.18149182-01 26 
0.18944302-01 27 
0.19772122-01 28 
0.20632612-01 29 
0.20635852-01 31 
0.25508162-01 32 
0.30342332-01 33 
0.35133132-01 34 
0.39880502-01 35 
0.44584382-01 36 
0. 49244732-01 37 
0.53861532-01 38 
0.58434762-01 39 
0.62964422-01 40 
0.67450512-01 41 
0.71893062-01 42 
0.76292092-01 43 
0 . 80647652-01 44 
0.8495979E-01 45 
0.8922857E-01 46 
0.93454082-01 47 
0.97636382-01 48 
0.10177562+00 49 
0.10587182+00 50 
0.10992512+00 51 
0.11393562+00 52 
0. 1179036E+00 53 


Figure 19-13. Control Variable Update Output 
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DEI* CHIP MAX- 0 . 9480E+00 DEL CHIY MAX- 0.1794E+00 BETCON- F KAT- 0 
VERSION NUMBER 2.00 

Figure 19-14 . Convergence Indicator Output 
19.3.14 Summary Tables (Format 14) 

At the conclusion of the converged trajectory iteration, the following tables are provided: the 
parameter summary table (shown in Figure 19-15), the orbital element summary table (shown in 
Figure 19-16), the load indicator table (shown in Figure 19-1 7), and the weight summary table 
(shown in Figure 19-18). Two tables are printed for both the orbital element summary table and the 
load indicator table if the branch trajectory is being simulated. The weight summary table format is 
vehicle system dependent, therefore, the current version of MASTRE has three weight summary 
formats consistent with the three vehicles systems that can be simulated. Variables defined in the 
orbital element summary table (. Figure 19-16) are defined in Table 19-5. 

19.4 POST PROCESSOR OUTPUT 

This subsection describes the output provided by the two optional post processor modules. 

19.4.1 Parameter Summary Table Post Processor 

As discussed in Subsection 15.3, an optional set of parameter summary tables can be output 
on the FOR021.DAT file at the termination of the converged trajectory. A separate Namelist array, 
“INPUT2”, is used to activate the table output. This Namelist array is defined in a separate file under 
the file name “ELTTBL.NL” and is automatically placed in the run stream when the parameter 
summary tables are requested. The inputs variables for this Namelist array are defined in Table 19-6. 
When using the parameter summary table, the user should modify the SRID arrays to allow the names 
of the events to be consistent with the vehicle events being simulated. 

Currently, 14 publishable tables are output. An example of the output produced by these 
tables is shown Figure 19-19. After printing these tables, a summary table is provided that defines 
the variable names, the table index, the units, and the definitions of the variables. 

19.4.2 Propulsion Output Table 

Figure 19-20 is an example printout of the propulsion output table. As discussed in 
Subsection 15.3, this is an optional table and, when activated, is output on the FOR007.DAT file. The 
definition of the variables used in this table are defined in Table 19-7. 
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1.5 STAGE MISSION 2 - 6/2 BRANCH TRAJECTORY 


case -NOM 


TIME 

332.263527 

SEC 

RANGE 

493.41 

NM 

RANGE ANGLE 

9.428548 

DEG 

INERTIAL 

VELOCITY 

7853.5011 

M/SEC 

RADIOS 

6526321.56 

M 

FLIGHT 
PATH ANGLE 

-0.000271 

DEG 

IN CL 

28.465700 

DEG 

DES. 

NODE 

86.822780 

DEG 

FLIGHT 

AZIMUTH 

90.000000 

DEG 

GDLAT 

27.922883 

DEG 

GCLAT 

27.763942 

DEG 

LONG 

-71.327779 

DEG 

INERTIAL 

AZIMUTH 

96.547644 

DEG 

Cl 

0.51254474E+11 

H**2/SEC 




HEIGHT 

214024.77 

LBS 

C3 - 

0.60474393E+08 

H**2/SEC* 

*2 



KEPLER I AN 

ORBITAL PARAMETERS 







ECNTRICY 

0.009849 


APOGEE 

RADIUS 

6656157.27 

M 

PERIGEE 

RADIUS 

6526321.55 

M 

APOGEE 

HEIGHT 

150.106515 

MM 

PERIGEE 

HEIGHT 

80.000838 

NM 





Figure 19-16. Orbital Element Summary Table 
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.5 STAGE MISSION 2 - 6/2 BRANCH TRAJECTORY 
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Figure 19 - 1 7. Load Indicator Table 



1.5 STAGE MISSION 2 - 6/2 BRANCH TRAJECTORY 


NOMINAL 


ENGINE OUT 


PAYLOAD 

OP PER STAGE - JETTISON WEIGHT 

- INERT STRUCTURE 

- FLIGHT PERFORMANCE RESERVE 

- DELTA VELOCITY PROPELLANT 

- EXCESS PROPELLANT (PROP LD) 

- FUEL BIAS 

- PROP RESIDUALS /UNUSABLE 
WEIGHT AT ORBIT INSERTION 

UPPER STAGE - PROPELLANT BURNED 

WEIGHT AFTER 2ND STAGE SEPARATION 

PERFORMANCE MARGIN - PAYLOAD 
- OTHER 

2ND STAGE - JETTISON WEIGHT 

- STAGE INERT WEIGHT (LESS ENG) 

- NONPROPULS I VE CONSUMABLES 

- DRY WEIGHT OF ENGINE (S) 

2ND STAGE - TOTAL WEIGHT AT 2ND STAGE SEP 

- PROP RES IDUALS/UNU SABLES 

- FLIGHT PERFORMANCE RESERVE 

- FUEL BIAS 

- MPS THRUST BUILDUP 

- BO ILOFF, OVERFILL, DRAINBACK 
EXCESS MPS PROPELLANT (MPS PROP LOADED) 
SHROUD WEIGHT SEPARATED AT MECO 

INJECTED WEIGHT AT MECO 

SHROUD JETTISON WEIGHT 

PROPELLANT BURNED - SEPARATION TO MECO 
WEIGHT AT SEPARATION 


0. 

0. 

0. 

0 . ( 

0. ( 

0. 

0 . 


0. 


0 . 

0 . 

151656. 

109350. 

0 . 

18200. 


62368. 


0. F/S) 

0 .) 


62368. 


6236B . 


0. 

0. 

0. 

0 . ( 

0. 

0. 

0. 


0. 


214025. 


12761. 

5571. 

0. 

0. 

0. 

5774. ( 1781045.) 

0. 


0. 

0. 

148902. 

109350. 

0. 

18200. 


12761. 

5571. 

0. 

0. 

0 . 

3020. ( 

0. 


214025. 


12500. 

490179. 


12500. 

492933. 


716704. 


Figure 19-18. Weight Summary Table 


62368. 

. F/S) 

62368. 

62368. 

211270. 

0 .) 

211270. 
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1.5 STAGE MISSION 2 - 6/2 BRANCH TRAJECTORY 


NOMINAL 


ENGINE OUT 


HEIGHT AT SEPARATION 


1ST STAGE - JETTISON HEIGHT 65962. 

~ STAGE INERT HEIGHT (LESS ENG) 65962 ! 

- DRY HEIGHT OF ENGINE (S) 0. 

- NONPROPULS IVE CONSUMABLES 0. 

- FUEL BIAS o! 

- PROP RESIDUALS /UNUSABLES q! 


PROPELLANT BURNED - LIFTOFF TO SEPARATION 1235606! 
LIFTOFF (T/W— 1 . 0) 

MPS PROPELLANT 0 

IGNITION COMMAND (T-0) 

1ST STAGE - MPS THRUST BUILDUP 30954 

- BOILOFF , OVERFILL, DRAINBAGK o! 

PRELAUNCH HEIGHT (T-5 MIN) 


716704. 


2030821. 


2030821. 


2061775. 


Figure 19-18. Weight Summary Table (Concluded) 
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Table 19-5. Orbital Element Summary Variables 


Variable 

Description 

Units 

TIME 

Time from lift-off 

s 

RANGE 

Relative range from launch point 

nm 

RANGE ANGLE 

Relative range angle 

deg 

INERTIAL VELOCITY 

Inertial velocity magnitude 

m/s 

RADIUS 

Radius from Earth’s center 

m 

FLIGHT PATH ANGLE 

Inertial flight path angle 

deg 

IN CL 

Inclination angle 

deg 

DES. NODE 

Descending node 

deg 

FLIGHT AZIMUTH 

Launch azimuth angle 

deg 

GDLAT 

Geodetic latitude angle 

deg 

GCLAT 

Geocentric latitude angle 

deg 

LONG 

Longitude angle 

deg 

INERTIAL AZIMUTH 

Inertial azimuth angle 

deg 

Cl 

Angular momentum magnitude 

m 2 /s 

WEIGHT 

Mass at injection 

lbm 

C3 

Vis viva interval (twice the energy) 

m 2 /s 2 

ECNTRICY 

Orbital eccentricity 

— 

APOGEE RADIUS 

Radius at apogee 

m 

PERIGEE RADIUS 

Radius at perigee 

m 

APOGEE HEIGHT 

Apogee altitude above equatorial radius 

nm 

PERIGEE HEIGHT 

Perigee altitude above equatorial radius 

nm 


Table 19-6. “INPUT2” Namelist Variables 


Variable 

Type 

Description 

Size 

NCASE 

Int 

Case index number 

1 

OFFICE 

Char 

Office symbol 

char* 12 

TITLE 

Char 

Title simulation 

char*48 

DATE 

Char 

Date of simulation 

char* 12 

SRIIX30) 

Char 

Optional titles, SRID(1-15) are substituted for 
“THRUST EVENT” events and SRIIX15-30) 
substituted for the “WEIGHT DROP” events 

char*12 

NOTAB 

Int 

Number of table 

1 
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Figure 19-19. Parameter Summary Table 
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Figure 19-19. Parameter Summary Table (Continued) 
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Figure 19-19. Parameter Summary Table (Continued) 
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Figure 19-19. Parameter Summary Table (Continued) 
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Figure 19-19. Parameter Summary Table (Continued) 
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Figure 19-20. Propulsion Output Table 



Table 29-7. Propulsion Output Table Parameters 


Variable 

Description 

Units 

Time 

Time from lift-off 

s 

Acel 

Axial acceleration 


LOX Level 

Level of LOX in tank 

in. 

LOX Mass 

Mass of LOX in tank 

lbm 

Fuel Level 

Level of LH2 in tank 

in. 

Fuel Mass 

Mass of LH2 in tank 

lbm 

Vac Thrust 

MPS vacuum thrust 

lbf 

Propellant 

Ibtal onboard MPS propellant mass 

lbm 

Inlet Pres 

Inlet pressure 

lbf/in. 2 
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APPENDIX A. USER INTERFACE FOR MASS PROPERTIES PR OGRAM 


A.1 INTRODUCTION 

This Appendix outlines the use of the special User Interface Program used with the Mass 
Properties Program that was developed for the MASTRE Program. The Mass Properties Program is a 
stand-alone, menu-driven VAX/VMS input/output interface program. This program was created to 
provide data to the MASTRE Program such that mass properties calculations can be performed in a 
dynamic fashion. The purpose of the Mass Properties Program is to replace the previous mass 
properties methodology, which was based on the interpolation of axial and normal CG as a function of 
weight overboard. The previous methodology introduced errors into the code due to variable staging 
times and event sequences. Additional information about the methodology and equations used in the 
Mass Properties Program are discussed in the MASTRE Engineering Manual. 

In general, each vehicle may be thought of as being composed of modules. A module will be 
created for inert payloads, solid motors, nonthrottable liquid engines, throttable liquid engines, or 
hybrid (solid/liquid) motors. Once created, individual modules are connected to specify the overall 
vehicle. Also, previously created modules can be used in other vehicle configurations by reconnecting 
them. Therefore, once a library of modules has been created, many different vehicles may be 
implemented. 

The modularity of the program is demonstrated in Figure A-l. In this figure, the 
Redesigned Solid-Rocket Motor (RSRM) module was created using the Solid Motor Module, and the 1.5 
Stage Common Core was created using the throttable engine module. Each module is created in a local 
coordinate system that, in this case, was located at the nose of the module. This particular location is 
not mandatory as the user may choose any reference location. Once the modules are created, they can 
be connected by specifying their locations in a global coordinate system. The global coordinate system 
shown in Figure A-l is the National Launch System (NLS) coordinate system, which is 2,000 in. in 
front of the previous Space Shuttle system. 

Once a vehicle is created and configured using the program, it can be accessed by the 
MASTRE Program by specifying the use of the alternate mass properties in the User Interface 
Program (see Section 15) and placing the name of the vehicle file into the MASTRE command file. The 
reference locations of the global coordinate system must also be input. 

The Mass Properties Program is activated by the user typing the command "RUN CG" and 
utilizing the many menu options available to him. Figure A-2 shows the first menu that appears when 
the Mass Properties module is initiated. As can be seen in this figure, Inert Payloads, Solid Motors, 


A-l 



Nonthrottable Engines, Throttable Engines, Hybrid Motors, and Merge Module are optional items on 
the menu. Each of the motor dependent items may be entered to create a module. 



RSRM 1.5 STAGE COMMON CORE RSRM 


Figure A-l . Example Vehicle Configuration 

The Merge Module option displayed in the menu is the overall vehicle creation module. This 
option is used once all of the modules for a vehicle configuration have been created. The modules are 
connected in the Merge Module to form an overall vehicle coordinate system. Units used in the Mass 
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Properties Program are inches for measurements and pounds mass for mass. The headings on the data 
tables within the program provide unit requirements for the user. 


New CGs 


\\\\\\\\\ /////// 

Inert Payloads 
Solid Motors 
Throttable Engines 
Non-throttable Engines 
ill Hybrid Motors 
Merge Module 
End Computations 


Figure A-2. New CGs or Main Menu 
AJ2, KEYPAD OPERATIONS 

All of the input/output operations in the mass properties User Interface Program are made 
using the operations keypad. The keypad layout is show in Figure A-3. Keypad operations defined in 
Section 3 are the same in the Mass Properties Program and will be summarized here. 


r \ 



CD 

©CD CD 

V J 

Figure A-3. VT 220 Keypad Definition 

When in the edit mode, the Insert Here Key allows the user to insert a new data entry line 
above a data item that is high-lighted; the Remove Key allows the user to delete the data entry line 
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that is currently high-lighted; the Select Key allows the user to make an entry into the position that is 
currently high-lighted; and the Prev Scrn and Next Scm keys allow the user to switch between screens. 
The Find key is not used with the Mass Properties Program. After these data have been entered for 
the current screen, or screens, pressing the Return Key will move the user to the next screen. 

Several features have been built into the input/output editor. If the user makes a mistake 
entering data incompatible with the currently high-lighted field, the program will display the previous 
value in the field. Also, if the user mistakenly presses the Select Key or forgets what the previous value 

of a selected field was, pressing the Return Key before any entries are made will restore the previous 
value of the field. 

A-3 INERT PAYLOADS MODULE 

The inert payloads module compiles and computes the CG for all of the inert components. 
This module was created with the intention that any excess inert components (those not in a solid- 
motor, nonthrottable engine, throttable engine, or hybrid engine module) would be inserted in this 
module. The inert components of an engine or motor are grouped with the liquid or grain data for 
modularity reasons. 

Inert components entered into this module can be referenced to any local coordinate system. 
However, it is advisable to use something that could be easily transported to other configurations. For 
the 1.5 Stage Vehicle shown in Figure A-l , the tip of the nose was used as a local reference point, and 
then referenced to the overall coordinate system. 

A flow chart of the user interface requirements for use of the Inert Payloads Module is shown 
in Figure A-4. The first screen, after selecting "Inert Payloads" from the "New CGs” screen, offers the 
user the choice of selecting from existing files, creating a new file, or returning to the overall selection 
menu. The user selects the existing files choice in case a file needs to be updated, examined, or used 
as the basis for a new file. Selection of this option will display all of the current data files that have 
the .IPI extension, which is the next block shown. All input files to the module have a ".IPI" 
extension, and all output files to the module have a ’.IPM" extension. The user may then select which 
file to open. The new file choice requires completely starting from the beginning to create a new file. 

The next screen contains the input and output section for the inert components. Each part 
is entered with its name, axial CG location, lateral CG location, normal CG locations, and mass. The 
CG locations of the inert components are referenced to the local coordinate system that the user 
chooses. Figure A-5 shows example inert components referenced to a local coordinate system. The 
operations of adding a new part, deleting a part, and modifying data are accessed using the function 
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— Inert Payloads — 


Edit existing data file 


Create new data file 
Return to previous menu 


■Inert Payload Files - 
1PT5STAGE.IPI;2 


HLLVJPI-4 


PD51.IPI;1 


100.00 

200.00 

2300.26 

3100.54 


0.00 

7894.34 

0.00 

2000.00 

i iMmM 

44365.43 

-2.54 

23489.12 


-^Save file options — 


Save this file with old name 


Save this file with new name 
Do not save this file 


Save file options 


Enter new name=> 


Figure A-4. Inert Payloads Program Flow 
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keys. Once all of the changes have been made to the data, the Return Key will send the user to the 
"save selections". 



Figure A-4. Inert Payloads Program Flow 

The next screen displayed allows the user to save the data just entered with the old file name 
(if it is not a new file), to save the data with a new file name, or not to save the data. If the old file name 
option is selected, the modified data will be written over the old file with that name, and the old file 
data will be lost. If the new file name option is selected, the user will be requested to input the file 
name where the data are to be saved. If a previously used file name is entered, the file will be written 

to the name, but a new version number will be assigned. Any previous files with that name will not be 
modified. 

After selections for file saving have been completed, calculation options will be displayed. If 
no calculations are required, the user is returned to the main menu. If calculations are required, an 
input file is required. An input file that has been saved previously does not have to be reformulated. 
If the data formulated in the first part of the module were not saved, the user is required to select 
another input file to use for the calculation of the mass properties data. If this option is selected, all of 
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(900,-50,0) 



(800,0,0) 




M (900,50,0) 



Figure A-5 . Example Inert Components 



the current input files are displayed for the user. After these operations, the user is returned to the 
main menu. 

A.4 SOLID MOTOR MODULE 

The Solid-Motor Module is composed of the solid grain, casing, and inert components that are 
used for a solid motor. The base calculation code for this module is the Solid-Rocket Motor Design 
Optimization Program (SRMDOP), which is documented in Reference 1. This program has been 
subjugated to the Mass Properties Program while still retaining its useful features. The module uses 
the user-defined grain shape and computes the regression rates of the grain versus time. The grain 
shapes that can be implemented are circular perforated, standard star, truncated star, wagon wheel, 
and tabular data. After computing the regression rates, the Solid-Motor Module calculates the CG 
location versus mass overboard. 

The Solid-Motor Module can be used to maximize total impulse to motor weight, minimize 
motor weight, or to match a thrust versus time history. For most of the applications foreseen, matching 
the thrust trace should be the appropriate choice. When using any of the above options, the user may 
choose from 17 parameters to optimize the requirements. 

To access the program, “Solid Motors” is selected from the “New CGs” menu. The first 
options let the user choose an old data file to build on (see Figure A-8). The user is not allowed to start 
without data because of the complexity and the amount of inputs. 

Once an old data file has been selected, the user is presented with the “Menu” screen. This 
screen has all of the options for the various editing screens for the solid motor inputs. Each screen may 
be edited one at a time by high-lighting and selecting the screen. Upon return from a section, the high- 
light bar will remain on the section that was just edited, so that the user will know what section was 
just edited. Any or all of the sections may be edited. When editing is complete, the return option is 
selected, and the file may be saved and mass properties calculated. 

The first option in the solid motor menu is to modify the inert parts. The inert parts are all 
of the inerts that are unique to a solid motor. The name, mass, and reference location of the inert 
components are entered here. The inert components are limited to 100. Also, their reference location 
is referenced to the local motor coordinate system. The inerts shown in Figure A- 7 are taken from the 
RSRM and are referenced to the tip of the nose of the motor. The reference system for this system is 
shown in Figure A-8. 

The next 13 input/edit screens shown in Figure A-9 through A-21 will be discussed in a 
tabular format. All of the screens present data used in constructing the RSRM simulation. Many of 
the definitions used in the descriptions of these data have been extracted from Reference 1. 
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.Menu 


WWWWWWW/ //////////// / 
Inert Parts - Solid Motors 
Optimization inputs 
Program control inputs 
Basic propellant chars 
Basic motor dimensions 
Basic performance constants 
Basic grnicdnfig arrangement 
Tabular Values 
Basic geometry of cp grain 
Basic geometry of star grain 
Basic geometry of standard sta 
Thrust vs. time data to be fit 
Basic geometry of Wagon Wheel 
Basic geometry of truncated st 
Return to new cgs menu 


Figure A-6. Initial Solid Module Selections 
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iSol id Motor Inert Payload Data 


Name 

Axial 

U n 2- — 

Lateral 
_ Jin) 

Normal 

_(in)_ 

Mass 

(Lbm) 

BODY STRUCTURE 

126494 

-5.24 

2.01 

28474.90 

INV ENVI PROTEC 

1563.73 

-7.97 

8.23 

1676.80 

SEP AND RECOVER 

438.70 

-2.52 

7.97 

10369.80 

PRIME POWER 

488.50 

-52.00 

-39.00 

90.00 

ELECT AND INSTR 

1 155.06 

27.31 

27.58, 

1 182.60 

TVC SYS 

1889.51 

64.11 

-6.31 

2328.00 

RANGE SAFETY 

730.94 

58.19 

-0.65 

1 44.40 

FWD S CASE 

665.58 

0.00 

- 0.01 

2621 1.67 

FWD S INSULATIO 

658.67 

0.00 

0.00 

451 1.67 


Figure A- 7. Solid Module Inert Component Menu 
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Figure A-8. Solid-Motor Coordinate System 
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Indicate which parameters are to be optimized 
I => Optimize parameter 0 => Parameter remains fixed 
Use up/down arrow keys to move, Select key to cycle 


0 Initial throat diameter 

1 Nozzle exit diameter 

1 Nozzle exit half angle 

111 ] Axial cp grain length at nozzle end having addit. taper 

0 Difference in cp web thickness for axial length above 

0 Difference in cp web thickness at head & aft ends 

0 Average internal diameter of cp portion of grain 
0 Burning rate coefficient below transition pressure 
0 Angle nozzle end of cp grain makes with motor axis 

0 Initial total length of the cp grain 

0 Initial slant length of cp grain at nozzle end 

0 Initial total length of star shaped grain 

1 Fillet radius for star shaped grain 

0 Web thickness of truncated star segment of grain 
0 Web thickness of standard star segment of grain 
0 Web thickness of wagon wheel segment of grain 
0 Cusp radius for standard star in inches 


Figure A-9. Solid Module Optimization Parameter Menu 
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Program Control Inputs 


155.00 Max allowable nozzle exit diameter (In) 

3 Type of optimization procedure to use 

10.00 Min allowable limit of nozzle exit half angle (deg) 

20.00 Max allowable limit of nozzle exit half angle (deg) 

0.10 Min allowable limit of throat-to-port area ratio 

0.50 Max allowable limit of throat-to-port area ratio 

0.035 Min allowable limit of burning rate coef (in/s) 

0.040 Max allowable limit of burning rate coef (in/s) 

0.00 Min allowable limit of star grn fillet radius (in) 

2.00 Max allowable limit of star grn fillet radius (in) 

0.60 Min allowable limit for 1 -DI/DO for cp grain only 

0.60 Max allowable limit for 1 -DI/DO for cp grain only 

8.00 Min allowable limit of star grn web thickness (in) 

9.00 Max allowable limit of star grn web thickness (in) 

0.00 Min required ideal velocity (ft/sec) 

1.00 Initial stepsize for pattern search procedure 

1.00 Min allowed of initial step size 

1.00 Max number of pattern moves before search is terminated 

1 Controls amount of data ouput during search 

2 Option for output of initial & final motor traces 

F Fig for output of input thrust profile to Thrust. Inp 
F Fig for output of output thrust profile to Thrust. Out 
F Fig for output of detailed mass properties 
T Fig indicating whether BARF effects included 


Figure A- 10. Solid Module Program Control Input Menu 
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Basic Propellant Characteristics 


Use up/down arrow keys to move - Select to change values 
Return to go back to main solid menu 


1.20 

0.064 

0.03918 

0.35 

0.00 

1.00 

0.2E-07 

5162.0 


Ratio of burning rate exp above & below transition press 
Density of the propellant (Lbm/in'3) 

Burning rate coef below transition pressure 
Burning rate exponent below transition pressure 
Alpha - constant in flame ht. erosive buring model 
Beta - constant in flame ht. erosive burning model 
Viscosity of the propellant gases 
Input characteristic exhaust velocity (ft/sec) 


Figure A-ll. Solid Module Propellant Characteristics 
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Use up/down arrow keys to move - Select to change values 
Return to go back to main solid menu 


Estimated total grain length (in) 

Average web thickness for controlling grain (in) 

Nozzle exit diameter (in) [DE] 

Initial throat diameter (in) [DTI] 

Nozzle cant angle wrt longitudinal motor axis (deg) 

Nozzle half angle (deg) [ALFAN] 

Length of grain with taper not represented by ZO (in) [LTAP] 
Difference in web thickness assoc with LTAP (in) [XT] 
Difference in web thickness for controlling grain (in) [ZO] 
Temp sensitivity of CSTAR at constant pressure 
Transition press for switching Nl to N2 & A1 to A2 (lbf/in'2) 
Axial dist to top center of grn from sol mot ref loc (in) 
Lateral dist to top center of grn from solid mot ref loc (in) 
Normal dist to top center of grn from solid mot ref loc (in) 


Figure A- 12. Solid Module Motor Dimensions Menu 
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Basic Performance Constants 


Use up/down arrow keys to move - Select to change values 
Return to go back to main solid menu 


0.04 

1000.00 

10000.0 

0.98 

122.000 

130000.0 

1.20 

0.00947 

60.00 

625.00 

53.8 

0.0015 

60.0 

1.445 

0.0 

14.7 


Desired burn increment during tailoff (in) 

Distance burned at which propellant breakup occurs (in) 
Depress rate where propellant extinguishes (lbf/in'3) 
Thrust loss coefficient 
Estimated burn time (s) 

Height of burnout (feet) 

Ratio of specific heats of propellant gases 
Reference throat erosion rate (in/s) 

Grain temperature (F) 

Reference nozzle stagnation pressure 
Reference throat diameter 

Temperature sensitivity coef of press at constant K 
Reference temperature of grain (F) 

Effective gamma at nozzle exit plane 
Pressure for extinguishing propellant (Lbf/in'2) 

Initial atmospheric pressure (Lbf/in‘2) 


Figure A-13. Solid Module Performance Constants Menu 
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|t3asic Configuration & Arrangement, 



Figure A-15. Solid Module Tabular Input Menu 
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Basic Geometry for CP Grain 


Use up/down arrow keys to move - Select to change values - 

Nxt Scr for upper/lower scrns - Return to go back to main solid menu 


143.4 Average initial outside diameter (in) 

60.5 Average initial inside radius (in) 

3.00000 Number of flat burning slot sides (excluding end) 

8.72 Angle nozzle end of grain make w/ motor axis (deg) 

1 103.20 Initial length of cp grain (in) 

72.33 Init slant length of burning conical grain - nozzle end (in) 
0.0 Contraction angle at nozzle end (deg) 

90.0 Contraction angle at head end (deg) 

2.0 Beginning slot widths (in) 







156.47 

639.80 

959.69 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

T 

T 

T 

T 

T 

T 

F 

F 

T 

T 


Figure A-16. Solid Module CP Grain Geometry Menu 
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Basic Geometry for Star Grain 


Use up/down arrow keys to move - Select to change values- 

kjxt Scr for upper/lower scrns - Return to go back to main solid menu 


0. Number of flat burning slot side (not incl. nozzle end) 
156.47 Initial length of star shaped perforate. grain (in) 

1 1 . Number of star points 
72.0 Average star grain outside radius (in) 

1 .79 Fillet radius (in) 

0. Number of star nozzle end burning surfaces 
0.00 Initial width of the slots (in) 


Star Geometry Arrays' 


0.00 

0.00 

0 

T 

T 


0.00 

0.00 

0 

T 

T 


0.00 

0.00 

0 

T 

T 


0.00 

0.00 

0 

T 

T 


0.00 

0.00 

0 

T 

T 


Figure A-l 7. Solid Module Star Grain Geometry Menu 
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Figure A-19. Solid Module Thrust History Input Menu 
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[Geometry for Wagon Wheel 


Use up/down arrow keys to move - Select to change values 
Return to go back to main solid menu 


0.00 Thickness of the propellant web (in) 

0.00 Length of parallel sides of 2 sets of star pts (in) 
0.00 Length of parallel sides of 2 sets of star pts (in) 
0.00 Angles between slant sides of star pts (deg) 

0.00 Angles between slant sides of star pts (deg) 

0.00 Half widths of star points (in) 


Figure A-20. Solid Module Wagon Wheel Geometry Menu 


Geometry for Truncated Star 


Use up/down arrow keys to move - Select to change values 
Return to go back to main solid menu 


0.00 Initial radius of the truncation (in) 

0.00 Thickness of propellant web at bottom of slot (in) 


Figure A-21. Solid Module Truncated Star Geometry Menu 
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A.4.1 Optimization Parameters 

The optimization parameter menu, as shown in Figure A-9, allows the user to choose the 
parameters that will be modified to achieve the optimization that will be requested in the Program 
Control Inputs menu. Any or all of the parameters may be optimized when trying to match a 
optimization type. However, specifying more parameters takes more computer time to perform the 
search. It would seem advisable to limit the number of optimizations to the parameters that the user 
was most unsure so that the program will modify them to match the thrust profile. If none of the 
parameters are optimized, the grain will be analyzed one time on the basis of the input parameters. 

All of the parameters presented in this menu are shown in Table A-l and will be documented 
later in this Appendix. 

A.4.2 Program Control Inputs 

Program control inputs are displayed in Figure A-10, and the variables are defined in 
Table A-2. The variables can be modified by using the up and down Cursor Arrow Keys to high-light 
the selection, pressing the Select Key, keying in the value, and pressing the Return Key. 

A.4.3 Basic Propellant Characteristics 

Basic propellant characteristics are displayed in Figure A-ll, and the variables are defined 
in Table A-3. The variables can be modified by using the up and down Cursor Arrow Keys to high- 
light the selection, pressing the Select Key, keying in the value, and pressing the Return Key. 

A.4.4 Basic Motor Dimensions 

Basic motor dimensions are displayed in Figure A-12 , and the variables are defined in 
Table A-4. The variables can be modified by using the up and down Cursor Arrow Keys to high-light 
the selection, pressing the Select Key, keying in the value, and pressing the Return Key. 

A.4.5 Basic Performance Constants 

Basic performance constants are displayed in Figure A-13, and the variables are defined in 
Table AS. The variables can be modified by using the up and down Cursor Arrow Keys to high-light 
the selection, pressing the Select Key, pressing in the value, and pressing the Return Key. 

A.4.6 Basic Configuration and Arrangement 

Basic configuration and arrangement inputs are displayed in Figure A-14, and the variables 
are defined in Table A-6. The variables can be modified by using the up and down Cursor Arrow Keys 
to high-light the selection, pressing the Select Key, keying in the value, and pressing the Return Key. 
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Table A-J. Optimization Parameters 
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Table A-2. Program Control Inputs 


Parameter 


Description 


Units 


Maximum Nozzle 
Exit Diameter 


Optimization 

Procedure 


Minimum Nozzle 
Exit Half Angle 


Maximum Nozzle 
Exit Half Angle 


Minimum Throat - 
to-Port Area 


Maximum Throat- 
to-Port Area 


Minimum Burning 
Rate Coefficient 


Maximum Burning 
Rate Coefficient 


Minimum fillet 
Radius 


Maximum Fillet 
Radius 


Minimum Web 
Fraction 


The maximum allowable nozzle exit diameter. The 
program internally constrains this value to be twice 
as great as the initial throat diameter. 


Optimization options: 

1 - Maximize total impulse to motor weight, 

2 - Minimize motor weight, and 

3 - Match input thrust versus time history 


Minimum allowable limit of the nozzle exit half 
angle. A lower limit of 10° is recommended for a 
straight conical nozzle. If a bell -shaped nozzle is 
simulated, the value should be somewhat lower. 


Maximum allowable limit of the nozzle exit half 
angle. An upper limit of 20° is recommended for a 
straight conical nozzle. 


The minimum allowable limit on the throat-to-port 
area ratio. This value controls the range of the 
throat diameter. The minimum limit should be 
selected with a viewpoint toward attaining 
reasonable volumetric efficiency. 


The maximum allowable limit on the throat-to-port 
area ratio. This value controls the range of the 
throat diameter. Consideration should be given to 
the erosive burning characteristics of the propellant 
when specifying this value. 


The minimum allowable burning coefficient. 
Corresponding densities, processing characteristics, 
and strengths should be considered in selecting this 
limit. 


The maximum allowable burning rate coefficient. 
Corresponding densities, processing characteristics, 
and strengths should be considered in selecting this 
limit. 


The minimum allowable limit on the star grain fillet 
radius. Stress considerations would ordinarily 
govern selection of this value. 


The maximum allowable limit on the star grain fillet 
radius. This value should be selected considering a 
reasonable volumetric loading density. 


The minimum allowable web fraction (1. -DI/DO) for 
a CP grain or grain segment. Since DO is fixed, the 
value of web fraction is controlled by the average 
initial internal grain diameter for each 
configuration. This value should be selected 
considering volumetric density. 


in. 


deg 


deg 


in./s-psia r Yate 


in7s-psia n 


in. 
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Table A-2 . Program Control Inputs (Continued) 


Parameter 


Maximum Web 
Fraction 


Description 


Minimum Star 
Grain Web 
Thickness 


Maximum Star 
Grain Web 
Thickness 


Minimum 
Required Ideal 
Velocity 

Initial Step Size for 
Search 


Minimum Step Size 


Maximum Number 
of Pattern Moves 


Search Detail 
Printout 


The maximum allowable web fraction (1.-DI/D0) for 
a CP grain or grain segment. Since DO is fixed, the 
value of web fraction is controlled by the average 
initial internal grain diameter for each 
configuration. This value should be selected with 
respect to the estimated value of initial throat 
diameter to avoid excessive erosive burning 
problems. 

The minimum allowable star grain web thickness. 
The limit will usually be based on the desired total 
burning time with regard to the value or range of 
burning rates specified. The user should remember 
that computer operating time, in general, can be 
greatly reduced by specifying reasonable ranges of 
values, especially when the accuracy of the starting 
value is in question. 

The maximum allowable star grain web thickness. 
The value might be determined based on desired 
burning time with some consideration of the general 
trace shape characteristics obtained with thick- 
webbed star grains. 

The minimum required ideal vehicle velocity. This 
variable is used only with optimization options 1 or 
2 . 

The initial step size for the pattern search. A value 
of 1.0 corresponds to a 5 % change in optimization 
variables for both exploratory and pattern moves. 

The minimum allowable step size for pattern search. 
The step size is halved whenever a series of moves 
fails to produce improvement in the objective 
function. The search is terminated when the step 
size becomes less than this value. 

The maximum number of pattern moves allowed 
before the search is terminated. This provides the 
user an additional control over the extent of the 
search. 

Controls the amount of data on the details of the 
search that appears in the program printout 
1 - Printout of values of each variable used at each 
step of the search, the value of the objective function 
with each move, and identification of basepoints and 
types of moves (exploratory of pattern) 

0 - Minimum printout. Only the values 
corresponding to basepoints and pattern moves are 
printed. The final values of the variables are also 
printed. 

-1 - Printout consisting only of the final results. This 
consists of final variable values and the objective 
function. 
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Table A-2. Program Control Inputs (Concluded) 
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Table A-3. Propellant Characteristics 


Parameter 


Description 


Units 


Ratio of Burning 
Rate Exponents 

Propellant Density 

Burning Rate 
Coefficient 

Burning Rate 
Exponent 

First Constant for 
Erosive Burning 

Second Constant 
for Erosive Burning 

Gas Viscosity 

Characteristic 

Velocity 


Ratio of burning rate exponent above and 
below the transition pressure 

Density of the solid propellant 

Propellant burning rate coefficient in the 
equation r = aP" 

Burning rate exponent in the equation r = aP" 


Erosive burning coefficient in the Robillard- 
Lenoir Burning rate rule 

Erosive burning pressure coefficient in the 
Robillard-Lenior rule 

Absolute viscosity of the chamber gases 

Characteristic exhaust velocity. This is the 
gas dynamic characteristic velocity which can 
be obtained from the expression C* = (R T c ).5/ 
G, where R is the gas constant and T c is the 
adiabatic flame temperature of the propellant. 


lbm/in.3 

inys-psian 


in. 2,8 -ft a8 /s 1 ,8 lbf 8 


lbf-s/in.-ft 

ft/s 


Table A-4 . Primary Basic Motor Dimensions 
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Table A-4. Primary Basic Motor Dimensions (Concluded) 


Parameter 

Description 

Units 

Nozzle Can’t Angle 
[THETA] 

Can’t angle of the nozzle with respect to the 
motor axis 

deg 

Nozzle Exit Half Angle 
[ALFAN] 

Exit half angle of the nozzle 

deg 

Length First Thiloff [LTAP] 

Estimated axial length of grain at the aft end at 
the start of first tailoff having an additional 
taper not represented by either the controlling 
grain web thickness [ZO] or the nozzle end grain 
angle [THETAG]. This variable permits the 
designer to specify an additional taper at the 
nozzle end of a circular perforated or star grain 
to produce regressively shortly before tailoff. 

in. 

LTAP Web Thickness [XT] 

Difference in web thickness at ends of LTAP 

in. 

Controlling Grain Web 
Thickness [ZO] 

Initial difference between web thickness at the 
head and aft ends of controlling grain length, 
not including any initial length associated with 
LTAP or THETAG. The controlling length of the 
grain is the axial length between the head end of 
the grain and the position of expected maximum 
Mach number in the port. It may be assumed, 
in most cases, that this length terminates 
whenever there is an abrupt decrease in web 
thickness near the aft end of the chamber or 
when THETAG is greater than 5°. 

in. 

CSTAR Sensitivity 

Temperature sensitivity of CSTAR at constant 
pressure 

— 

Transition Pressure 

Transition pressure for switching N1 to N2 and 
A1 to A2 

lbf/in. 2 

Axial Reference 

Axial distance to top centerline point of grain 
from solid-motor reference location 

in. 

Lateral Reference 

Lateral distance to top centerline point of grain 
from solid-motor reference location 

in. 

Normal reference 

Normal distance to top centerline point of grain 
from solid-motor reference location 

in. 

j 
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Table A-5. Basic Performance Constants 


Parameter 

Description 

Units 

Initial Bum Increment 
[DELTAY] 

Initial desired bum increment. This increment will be used by 
the program for the initial 5% of the web thickness burned, for 
the period shortly preceding and following tailoflf, and at such 
other times as the rate of pressure change is large. Larger 
increments will automatically be used at other times. An 
initial increment size of approximately 0.005 t* is 
recommended, but larger increments may be used for relatively 
flat burning surface versus distance burned traces. 

in. 

Breakup Bum Distance 
tXOUT] 

Distance burned at which the propellant breaks up. This 
permits the option of specifying termination of burning 
resulting from possible structural breakup of the propellant. If 
this option is not desired, the parameter should be set to some 
large value; e.g., 1,000 in. 

in. 

Extinguishing Pressure 
Change [DPOUT] 

Rate of change of pressure with respect to distance burned at 
which the propellant is extinguished. This permits the option 
of specifying termination of burning resulting from rapid 
depressurization. If this option is not desired, the parameter 
should be set to some large value; e.g., 10,000 psia/in. However, 
if an abrupt tailoff is expected, a smaller value of the parameter 
must be specified as the computer will not otherwise be able to 
handle the discontinuity. For a large motors (120 in. diameter 
and up), a value of 500 psia/in. is recommended and 
proportionately larger values for smaller motors. 

lb/in. 3 

Thrust Loss Coefficient 

Thrust loss coefficient. In the absence of data to the contrary, a 
value of 0.98 is recommended. 

— 

Bum Time 

Estimated burning time. This and the estimated burnout 
altitude permit the program to calculate delivered specific 
impulse and thrust based on an assumed trajectory determined 
from analysis of typical large SRM applications. 

s 

Height of Burnout 

Estimated burnout altitude, lb obtain sea level performance 
characteristics, this parameter should be set equal to zero. 

ft 

Ratio of Specific Heats 

Ratio of specific heats for propellant gases 

— 

Reference Erosion Rate 

The reference erosion rate of the nozzle at a stagnation 
pressure of reference pressure 

in Js 

Temperature of Grain 

The average temperature of the SRM grain at the moment of 
ignition 

op 

Reference Pressure 

The nozzle stagnation pressure at which the erosion rate is 
referenced 

Ibf/in. 2 

Reference Throat 
Diameter 

The reference throat diameter. 

in. 

Temperature Sensitivity 
of Pressure 

Temperature sensitivity coefficient of at constant K 

— 
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Table A-5. Basic Performance Constants ( Concluded ) 


Parameter 

Description 

Units 

Reference Temperature 

The design temperature of the grain. Usually the temperature 
at which the booster propellant is cured and at which all 
theoretical ignition simulations are started. 

op 

Ratio of Specific Heats at 
Exit 

The effective value of the ratio of specific heats (g) at the exit 
plane 


Extinguishing Pressure 

The pressure at which the propellant extinguishes. Usually 
near zero. 

lbf7in. 2 

Initial Atmospheric 
Pressure 

The ambient atmospheric pressure just prior to ignition 

Ibf/in. 2 


Table A-6. Basic Configuration and Arrangement 


Parameter 

Description 

Units 

Number of 
Termination Ports 

Number of thrust termination passage-ways in grain. Zero if there are no 
thrust termination passageways. 

... 

Diameter of 
Termination Ports 

Figure A-27 

in. 

Input Type 

Input options 

1 - tabular input 

2 - equation input 

3 - combination of 1 and 2 


Grain Type 

Grain type options 

1 - entirely circular perforated grain 

2 - star grain only 

3 - combination of 1 and 2 


Star Type 

Star grain options 

1 - standard star 

2 - truncated star 

3 - wagon wheel (a standard star may not be combined with a truncated star) 


Star and CP 
Configuration 

Grain order options 

1 - a star grain is at the head end and a circular perforated grain is at the aft 
controlling end 

2 - a circular perforated grain is at both ends, a star grain segment may still 
be present. 

3 - a circular perforated grain is at the head end and a star is at the aft 
controlling end 

4 - a star grain is at both ends. If grain type is equal to 1, order must be 2. If 
grain type is equal to 2, order must be 4. It is important to realize that the 
grain order establishes the controlling port area equations to be used. Thus, 
if the nozzle end segment is not indeed the controlling one (the one that 
establishes the maximum Mach number in the port), the order should be 
specified to designate the actual controlling segment as the nozzle end 
segment. The grain type, star type, and grain order are not used for input 
type equal to one. 
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Table A-6. Basic Configuration and Arrangement (Concluded) 


Parameter 

Description 

Units 

Circular Perforated 
End Configuration 

Options for extreme ends of circular perforated grain only: 

1 - both ends are conical or flat 

2 - head end is conical or flat and aft end is spherical 

3 - both ends are spherical 4 - head end is spherical and aft end is conical or 
fiat 


Number of Thbular 
Inputs 

The number of tabular input sets versus distance burned to be input 

... 


A.4.7 Tabular Values 


Tabular value inputs are displayed in Figure A-15, and the variables are defined in 
Table A- 7. The variables can be modified by using the up and down Cursor Arrow Keys to high-light 
the selection, pressing the Select Key, keying in the value, and pressing the Return Key. 

A.4.8 Basic Geometry for CP Grain 

Inputs for the basic geometry for the circular perforated grain are displayed in the menu 
shown in Figure A-16. The variables of this menu are defined in Table A-8. This input is not required 
for completely star grain or for tabular inputs. 

The CP geometry arrays menu allows the user to enter more slot and termination port data 
for the circular perforated grain. The first two entries are the longitudinal locations of the slots and 
termination ports. These locations are referenced to the top of the total grain. Next, the number of 
termination ports may be entered. The termination ports are assumed to be spaced at equal angles 
perpendicular to the longitudinal axis. Finally, the slot bum directions may be specified. These entries 
were incorporated to allow the grain in the RSRM to bum longitudinally forward from the field joints, 
but not backwards. Entering "T" in the fourth row allows the slot to bum longitudinally forward, and 
entering "T” in the fifth row allows the slot to bum longitudinally backward. If "T" is entered in both 
rows, the slot will bum both forwards and backwards. 

A.4.9 Basic Geometry for Star Grain 

Input for the basic geometry for the star grain is display shown in Figure A-17. Variables 
in this figure are defined in Table A- 9 . This input is not required for entirely circular perforated 
grains or for only tabular inputs. The wagon wheel is considered a type of star grain for the purpose 
of this program. 

The star geometry arrays menu is used in conjunction with the basic star geometry screen. 
The first two rows of this star geometry screen are used to input the longitudinal locations of the slots 
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Figure A- 24 . Truncated Star Grain Cross Section 
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Figure A-25. Wagon Wheel Grain Cross Section 


Tabular Input Option 

Equation Input Option 

43.52 44.65 1 
0.0 0.95 

1.0 0.98 

2.0 0.99 

3.0 1.01 

4.0 1.02 

5.0 0.97 

43.52 44.65 2 

20.0 

1.1 2.0 3.4 5.3 2.4 1.2 

4.3 1.0 9.3 0.2 2.6 0.9 


Figure A-26. BARF Input Options 








and termination ports for the star grain segment. These locations are referenced to the top of the total 
grain. The third row is used to enter the number of termination ports at each location. The 
termination ports will be equally spaced in a circle perpendicular to the longitudinal axis. The last two 
rows allow the user to specify the bum directions of the slots. The slots may bum longitudinally 
forward if "T" is specified in the fourth row, or longitudinally backward if "T” is specified in the last 
row. If ”T" is specified in both rows, the slot will burn both ways. This option was incorporated because 
the RSRM grain was observed to bum forward from the field joints but not backward. 



Figure A-27. Termination Port for Solid Motor 
A.4.10 Geometry for Standard Star 

Input for the standard star geometry is displayed in Figure A-18. Variables in the figure 
are defined in Table A-10. This input is not required for truncated star grains. 

A.4.11 Thrust Versus Time Data 

The thrust versus time data screen shown in Figure A-19 allows the user to input a thrust 
versus time history that the solid module will try to match by optimizing the chosen parameters in the 
Optimization Parameter screen. The variable in the figure are defined in Table A-ll. Up to 20 thrust 
versus time points may be entered in the array screen. Only used if optimization option 3 is selected 
in Program Control Inputs menu. 


A-34 




Table A- 7. Tabular Values 



Table A-8. Basic Geometry for CP Grain 


Parameter 


Description 


Units 


Average Outside 
Diameter [DO] 

Average Inside 
Diameter [DI] 


Number of Flat Ends 


Angle of Grain at 
Nozzle End [THETAG] 


Length average outside diameter of circular perforated grain, 
excluding lengths extending into the closure 

Length average inside initial diameter of circular perforated grain. 
Only the controlling length excluding the length of first tailofffLTAP] 
should be considered in the averaging. 

Number of burning flat ends of a circular perforated grain not 
including an extreme aft grain end 

Angle between the burning surface element of circular perforated 
grain located at the extreme nozzle end of chamber and the motor axis. 
Must be set to zero if a star grain is located at the nozzle end (grain 
type = 3, order = 3) or if aft end burning surfaces are represented by 
tabular values. Must be 90° if the circular perforated grain 
represented by equations has a flat burning surface located at the 
extreme nozzle end of the chamber. If less than or equal to 5°, a value 
must be assigned (zero is satisfactory), but the effect of the angle on 
burning surface area is not computed. The angle is zero if the end 
surface is flat and inhibited. 
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Table A-8. Basic Geometry for CP Grain (Concluded) 


Parameter 

Description 

Units 

Tbtal Grain Length 
[LGCI] 

Initial total axial length of circular perforated grain represented by 
equation inputs not including gaps. Lengths associated with THETAG 
are excluded. 

in. 

Slant Length 
Associated with 
THETAG [LGNI] 

Initial slant length of a burning conical circular perforated grain at the 
nozzle end. Is set equal to zero if THETAG is less than or equal to 5°. 
In this case, the length otherwise associated with the slant length 
should be added to the total grain length. If the error in burning 
surface area thus introduced is deemed significant, a correction may be 
introduced by making use of tabular inputs in combination with the 
equation inputs. Basic effect of small THETAG on tailoff may be 
accounted for by specification of the length of the first tailoff [LTAP]. If 
a nozzle end burning surface is fiat, the parameter equals one-half the 
difference between inside and outside local grain diameters. 

in. 

Contraction Angle at 
Nozzle [THETCN] 

The contraction angle of a circular perforated grain bonded to the 
nozzle closure. This parameter is not required if the circular 
perforated end configuration option is either 1 or 2. Use an estimated 
value that yields approximately the correct volume of propellant 
burned. If a star shaped grain is located at the extreme nozzle end of 
the chamber or if tabular values are used to represent downstream 
burning surfaces, the angle is 90°. The angle is also 90° if the extreme 
aft end of the grain is inhibited, but only a flat-ended inhibited grain 
that does not extend into the nozzle closure may be accurately 
represented. The angle is 0° for a burning flat end that does not extend 
into the closure. 

deg 

Contraction Angle at 
Head End [THETCHJ 

This parameter is not required if the circular perforated end 
configuration option is either 2 or 3. Use an estimated value that yields 
approximately the correct volume of propellant burned. The angle is 
90° if the extreme forward end of the circular perforated grain (bonded 
or not) represented by equations is flat. A head end flat burning 
surface is treated by proper specification of the number of flat ends. 

deg 

Slot Widths 

Beginning widths of slots in circular perforated grain. One value is 
used for all slots (shown in Figure A-28). 

in. 
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Table A-9. Basic Geometry for Star Grain 


Parameter 

Description 

Units 

Number of Flat Ends 

Number of burning flat end surfaces of a star grain not 
located at extreme nozzle end of the chamber 

— 

Tbtal Length [LGSI] 

Initial total axial length of star-shaped perforated 
grain represented by equations. No provision 
comparable to the use of LGNI for circular perforated 
grains is made here to treat effects resulting from 
THETAG greater than 5°. Adjustments may be made, 
however, by use of tabular input values in conjunction 
with the equation input. Also, effects of taper, 
including additional small taper at the nozzle end, on 
tail off may be treated by use of the variables ZO, XT, 
and LTAP. 

in. 

Number of Points 

The number of star points 

... 

Outside Radius 

The star grain outside radius 

in. 

Fillet Radius 

The fillet radius at star valleys 

in. 

Number of Flat 
Nozzle Ends 

Number of burning flat end surfaces (0 or 1) of a star 
grain located at the extreme nozzle end of the chamber 

-- 



Figure A-28. Slot for Solid - Motor 
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Table A- 10. Geometry for Standard Star Grain 


Parameter 

Description 

Units 

Angle Location of Fillet 
[THETAF] 

Angular location of the fillet center of standard star 
from line of symmetry 

deg 

Apex Angle [THE TAP] 

The apex angle of the star point 

deg 

Web Thickness [TAUWS] 

The web thickness of a standard star grain. If the 
grain is tapered, the length average value should be 
used. This parameter will be the same as TAU if the 
entire controlling length of grain is a star grain. 

in. 

Cusp Radius [RPNT] 

Star grain cusp radius 

in 


Table A-ll. Thrust Versus Time Data 


Parameter 

Description 

Units 

Number of Points 

The number of thrust versus time data 
points to be used for the thrust versus 
time trace 

... 

Objective Function Scaling 
Factor 

Scales objective function to a meaningful 
value of le-08 was used for the RSRM 

— 

Time 

The time of the thrust inputs 

s 

Thrust 

The thrust at the current time 

Ibf 

Weighting Factors 

The weighting factor for each thrust 
time pair. If all points are to be 
weighted equally, 1.0 should be used for 
the factor. 



A.4.12 Geometry for Wagon Wheel 

Wagon wheel geometry inputs are displayed in Figure A-20, and the variables are defined 
in Table A-12. The variables can be modified by using the up and down Cursor Arrow Keys to high- 
light the selection, pressing the Select Key, keying in the value, and pressing the Return Key. 

A4.13 Geometry for Truncated Star 

Truncated star geometry inputs are displayed in Figure A-21, and the variables are defined 
m Table A-12. The variables can be modified by using the up and down Cursor Arrow Keys to high- 
light the selection, pressing the Select Key, keying in the value, and pressing the Return Key. 
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Table A-12. Geometry for Wagon Wheel 


Parameter 

Description 

Units 

Web Thickness 

The web thickness of wagon-wheel grain. The discussion 
for standard star grain web thickness is applicable. 

in. 

Length of First Side 

The length of the first of the parallel sides of the first and 
second set of grain points 

in. 

Length of Second Side 

The length of the second of the parallel sides of the first 
and second set of grain points. 

in. 

Angle of First Point 

The angle between the slant side and the centerline of the 
point of the first grain point. Should not exceed p/2. 

rad 

Angle of Second Point 

The angle between the slant side and the centerline of the 
point of the second grain point. Should not exceed p/2. 

rad 

Star Half Width 

The half- width of the star points. Must not exceed web 
thickness. 

in. 


Table A-13. Geometry for Truncated Star 


Parameter 

Description 

Units 

Radius of Truncation 

The length average initial radius of the truncation 

in. 

Web Thickness 

The length average initial thickness of the 

in. 


propellant web at the bottom of the slots 



Once all of the input screens that required modification have been edited, the Return to New 
CGs" option should be selected from the Menu screen. After this, the user will be given the option to 
save the data just edited, Figure A -29. If the data are saved with the old name, the previous data will 
be erased, but if a new name is entered that corresponds to one already in the directory, the name will 
be used except with a higher version number. After saving the data, the user will be presented with 
choices about file calculation. When these selections have been made, the program will return to the 
"New CGs" menu. 

AJS THROTTABLE AND NONTHROTTABLE LIQUID ENGINE MODULES 

A liquid engine module is composed of all the liquid fuel, fuel tanks, oxidizer, oxidizer tanks, 
pressurization gas, pressurization tanks, and inert components in a liquid engine. The tanks are 
allowed to have ellipsoidal, ogival, or fiat ends, while the midtank section is assumed to be a cylinder. 
The tank elements are shown in Figures A-30 through A-32. Also, tabular inputs of CG location 
versus mass overboard are allowed for a specific tank or for the entire module. The tanks are assumed 
to be pressurized by a pressurization gas, either bled from the engine or from another onboard tank. 
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11 Save File Options- 

Isave this ;ll) e wliifaianarhel 
Save this file with new name 
Do not save this file 

1 1 i — 

——Save File Options- — 

Enter new name ==> 


— Calculation Menu — 

Select^Ue-t^ioafcutate 

No calculation 

? i 

——Calculation Menu^— 

1 PT5STAGF.TF1 ? 
HLLVT£l;4 
PD5 1 TEI; 1 

' T 

Figure A-29. Final Stolid Module Selections 


Calculation Menu 


Calculate 
No calculation 
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All of the input throttable files have a “.TEI” extension, and all of the input nonthrottable files have a 
w .NEr extension. The output files, have “.TEM” and “.NEM” extensions, respectively. 



Figure A-30. Revolved Ellipse Endcap 

For this module, the CG of the liquid in a tank was assumed to cause longitudinal changes 
in the CG only. No CG changes in the lateral or normal directions are allowed. The top surface of the 
liquid was assumed to remain perpendicular to the longitudinal axis of the tank. Also, the liquid was 
assumed not to slosh, the density of the fuel and pressurization gas was assumed to be constant, and 
no mixing was assumed to occur between the liquid and pressurization gas. Finally, no vortexes were 
allowed. 

The screens and logical flow of the user interface for the throttable and nonthrottable liquid 
engines are shown in Figure A-33. The sample data is the data used to develop the 1.5 Stage Common 
Core. In these data, the ".TEI" extensions may be replaced by ".NEI" extensions for a nonthrottable 
engine. 

The liquid engine modules are accessed by selecting “Throttable Engines” or “Nonthrottable 
Engines” from the screen in Figure A-2, After this, the sequence in Figure A-33 is followed. 
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Figure A- 31 . Revolved Ogive Endcap 

The first set of screens allow the user to choose whether to work with old data files or to use 
new data files. Old data files may be used if data are to be corrected, checked, or used as a basis for 
creating a new file. Once the file selection has been made, the “Engine Data” screen is displayed. 

The “Engine Data” screens allow the user to specify the tank parameters for the liquid 
engine. There is a complimentary screen that coordinates with this screen and may be accessed by 
using the Prev Scm and Next Scm Keys. To move internally in the screen, the Arrow Keys may be 
used. Also, tanks may be added and deleted by pressing the Insert and Delete Keys. 

The first screen allows the user to specify the type of tanks and the physical dimensions of 
the tanks. The tank types, second column, are standard, pressurization, and tabular. The standard 
tank is just a conventional fuel or oxidizer tank. A pressurization tank is one that is used to pressurize 
a fuel or oxidizer tank without adding any mass to the mass overboard. The tabular tank is for tanks 
that cannot be described physically by dimensions or for tanks that already have known CG properties. 
This option can also be used for an entire engine to specify its mass overboard versus CG location. 
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Figure A-32. Cylindrical Midtank 

The rest of the entries is the table are physical dimension variables. The height of the tank, 
column three, is the height of the cylindrical portion of the tank (see Figure A-32). If the tank is 
spherical, this value is zero. The radius of the tank, column four, is the cross sectional radius of the 
cylindrical portion or the end portion of the tank. Next, the endcaps of the tank may be either 
ellipsoidal, ogival, or flat. The ends are shown in Figures A-30 and A-31 . The options of ellipsoidal 
or ogival are selected in the top and bottom end type columns, columns five and seven. The heights of 
these ends, columns six and eight, are the longitudinal height of the end. To specify a flat end, a height 
of zero should be entered. 
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Edit existing data file 


Create new data file 
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■Inert data - Engines 


Name 

Axial 

(in) 

Lateral 

(in) 

Normal 

(in) 

Mass 

(Lbm) 

LOX TANK FWD & 

1210.56 

0.00 

0.00 

1889.00 

LOX TANK CYL & 

1392.48 

0.00 

0.00 

10779.00 

LOX TANK AFT BK 

1574.40 

0.00 

0.00 

4021 .00 

INTERTANK &INS 

1672.68 

0.00 

0.00 

12493.00 

LH2 TANK FWD BK 

1770.96 

0.00 

0,00 

2107.00 

LH2 TANK CYL & 

2310.96 

0.00 

6.6o 

42895.00 

LH2 TANK AFT BK 

2851 .07 

0.00 

QOO 

2616.00 


—Save File Options ■■■ 
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Save this file with new name 
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'Calculation Menu 


r Calculate • 


No calculation 


—Calculation Menu ■ 


Select file to calculate 


No calculation 
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The corresponding screen of engine datfl allows the user to enter other tank parameters. 
Note, the tank numbers in the first column correspond directly with the tank numbers on 
the previous screen. The fuel density, column two, is the density of the fuel in the tank. The mass 
flowrate, column three, is the average mass flowrate of the tank over the entire use of the tank. 
Column four are the values expected for the residuals to be left in the tank as a percentage of the initial 
mass. Pressurization tanks are coordinated with the tanks that they pressurize by entering the 
associated pressurization tank number in column five. One pressurization tank is not assumed to 
pressurize only one tank. The final three columns allow the user to enter the reference location of the 
tank in the local engine reference system. The engine is assumed to be referenced at the bottom center 
line point of the tank (see Figure A-34). 

The tabular data option for the liquid tanks is shown in Figure A-35. In this screen, tank 
number three is a tabular tank. When the high-light bar is on the third row, the tabular values appear. 
These values may be edited by using the Next Scrn Key. Because the tank is entered in tabular form, 
there are no physical dimensions associated with it. All of the other entries on the row are zero. 
However, the entries on the second screen must be completed. The reference location for the tank is 
again the bottom center line location of the tank referenced to the local tank coordinate system. 

Once the data that specify the tanks and fuel of the engine are input, the program asks the 
user for inert property data. The inert property data expected are unique to the liquid engines. By 
including the unique liquid engine data with the fuel and tank data, transportability to other vehicle 
configurations is maintained. These expected inputs are the name, mass, and reference location of the 
inert components. The reference location and the CG locations should be referenced to the local engine 
coordinate system used for the tanks. 

Saving and calculation options are the final choices to make in the liquid engine modules. An 
edited module may be saved with its old name, a new name, or not saved. If it is saved with its old 
name, the new data are written over the old data; if it is saved with a new name, no old data are lost. 
The file does not have to be saved if errors occurred in it. The calculation options are allowed after 
saving. If the file was saved, it may or may not be calculated. If the file was not saved, another file 
may be selected for calculation if desired. 

After these options, the liquid engine module sequence is complete. 

A.6 HYBRID ENGINE MODULE 

The Hybrid Engine Module is composed of the liquid tanks, liquid fuel, solid grain, grain 
casing, and inert components that compose a hybrid engine. A created module is self contained and 
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Figure A-34. Liquid Engine Reference Locations 
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can be easily transported to other vehicle configurations. The expected vehicle configuration is shown 
in Figure A-36. 

-Engine Data 1 


Tank 

Tank 

Height 

Radius 

Top end 

Top end 

Btm end 

Btm end 

# 

_type_ 

. J in ! - 

_(in)_ 
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1 

1 

323.0 
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23.0 
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23.0 
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2 
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1 
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1 

14.5 

3 

3 

|M:Q.O 

0.0 

0 

0.0 

0 
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****Tank Types*** 
*1=conventional 
*2=pressurization 
*3=tabular 


— tabular 
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0.0 
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118.4 

300.0 

98.4 

400.0 

45.3 

500.0 

35.9 

600.0 

135.3 


Figure A-35. Throttable and Nonthrottable Liquid Engine 
There are two important limitations of this module. First, the module does not include the 
complex equations required to calculate the burning rate of the grain. Therefore, the user must provide 
the flowrate and mixture ratios of the liquid and solid propellant versus time. Also, if the grain 
geometry is not entered in tabular form, it is assumed to be circularly perforated and burn outward at 
a symmetrical radial rate, which means that the grain CG will be at the middle of the grain length and 
will not change. 

To build a hybrid module, “Hybrid Engines” is selected from the “New CGs” menu. The first 
choice that the user must make is whether to use new or old data files. All of the input files have a 
“.HMI” extension, and all of the output files have a “.HMM” extension. An old data file may be used 
foe review or as a starting point to build a new file. If an old file is chosen, the user is given the choice 
of any of the available files in the directory. Once the choice of file type is made, data insertion begins 
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The first set of data that the user must enter is the liquid propellant data, in the “Engine 
Data” screens. Two screens are present here and may be accessed by using the Prev Scm and Next 
Scm Keys. Tanks may be added or deleted by using the Insert and Delete Keys. 

The first screen allows the user to specify the physical dimensions of the liquid tanks. In the 
second column, the user is allowed to enter the tank type. The types are conventional, pressurization, 
and tabular. The pressurization tank is used to pressurize any other type of tank, but its mass will not 
be considered as mass that will flow overboard. Column three contains the height of the cylindrical 
portion of the tank (see Figure A-37), and column four is used for the cross sectional radius of the tank. 
The final inputs for the first screen are for the top and bottom ends. The ends may be ellipsoidal, 
ogival, or flat. The type signifier for the top and bottom ends is entered in columns five and seven, 
respectively. The height of the ends is entered in columns six and eight. The height is the longitudinal 
height of the tanks. If a flat end is specified, its type should be ellipsoidal with a height of zero. 

By switching screens, the propellant, tank associations, and reference locations may be 
entered. The numbers in column one of the second screen correspond directly with the numbers in 
column one on the first screen. Columns two and three contain the fuel density and average mass 
flowrate of the fuel for a tank. The average mass flowrate is the expected average of the entire use of 
the tank. Column four allows the user to enter the expected residual amount to be left in the tank. 
This amount is a percentage of the original mass. The next entry, column five, associates the 
pressurization tanks with the tanks that require pressurization. The number of the pressurization 
tank should be entered in the row of the tank to be pressurized. Finally, the bottom center line position 
of each tank is referenced to the local engine coordinate system (see Figure A-38). 

The tabular data option for the liquid tanks is shown in Figure A-39. In this screen, tank 
number three is a tabular tank. When the high-light bar is on the third row, the tabular values appear. 
These values may be edited by using the Next Scm Key. Because the tank is entered in tabular form, 
there are no physical dimensions associated with it. All of the other entries on the row are zero. 
However, the entries on the second page must be completed. The reference location for the tank is 
again the bottom center line location of the tank reference to the local tank coordinate system. 

Upon completion of the liquid tank data, the grain data and mixture data may be edited. 
Switching between screen is accomplished using the Next Scm Key. The grain may be entered in 
either tabular form or parameter form. If the tabular form is chosen, the program will expect the 
longitudinal CG location of the grain to be entered as a function of mass overboard in the far right 
window. This window can hold up to 30 entries. If the parameter form of the hybrid grain is chosen, 
the length, mass and reference location of the grain are entered in the top left window. The reference 
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Figure A-37. Hybrid Module Flow Diagram 
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Figure A-38. Example Hybrid Reference Locations 
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location is from the bottom of the grain to the local coordinate system (see Figure A-38). The reference 


location of the grain still needs to be input in this window if the tabular option is used. 


— — Engine Data 

Tank Tank Height Radius Top end Top end Btmend Btmend 
# type (in) (in) type h£t (in) type hgtjinj. 
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Figure A-39. Engine Data Screen With Tabular Inputs 

The final entry in this section of screens is the time, flowrate, and mixture ratios. The 
program does not compute the burning rate of the solid grain and its combination with the liquid. 
Therefore, the user must input the total flowrate of the liquid and solid together and the mixture ratio 
of the liquid to solid by mass. This table is very important for the hybrid engine to produce accurate 
results. Up to 25 values may be entered here. 

After the grain and mixture data are entered, the inert components associated with the 
engine are specified. The expected program inputs are the name, reference location, and mass of all of 
the inert components. Again, the inert components should be referenced to the same local coordinate 
system as the liquids and solids previously entered. 

The file saving and calculation options are the last things to be determined. The file may be 
saved with an old name, which will write over the data of the file that was opened, or the file may be 
saved with a new name. If there is already a file with this name, this file will be created with a higher 
version number. The other option is used if mistakes have been made and no action is to be taken. 
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After these choices, the user is given calculation choices for the file just created, or for other files. If 
the file is not saved, the user is given the choice to calculate another file. 

A.7 MERGE MODULE 

The formation of the data to be used by MASTRE is performed after all of the individual 
modules that are needed for a particular vehicle have been created. Each individual module created 
will be self contained (inerts and fuel together) during its construction, but the modules will be 
decomposed and recombined to form an overall vehicle configuration. 

To begin merging the modules, "Merge Module" is selected in the "NEW CG's" menu. After 
this, the user is offered the choices of using an old data file or creating a new data file (see 
Figure A-40). Old data files may be used to check for accuracy or to begin building a new data file. If 
the old file option is chosen, all of the available merge files in the directory will be displayed, and the 
user may choose from them. All of the old input files have a “.MRG” extension, while all of the old 
output files have a extension. 

After the type of file has been selected, the inert payload module selections are made. All of 
the available files in the directory will be displayed in the left screen for the user (see Figure A-40). 
If the user has specified an old data file, any inerts selected in that file will be displayed in the right 
hand screen. By highlighting and pressing the Select Key, the user should select the files in the left 
screen that will be used for the vehicle, and they will then appear in the right screen. If any modules 
are mistakenly transferred, or any of the modules are obsolete, the user may go to the right screen and 
delete any of the entries that are invalid. 

Once all of the inert payload files that are needed for a vehicle have been selected and placed 
in the right window, the user should enter their respective reference locations in the right screen. For 
the case shown (see Figure 4-40), the 1PT5STAGE.IPM module is referenced to the tip of the nose of 
the 1.5 Stage Common Core vehicle when it was created. However, the global coordinate system is 
1306.6 inches in front of the local system. Therefore, a reference length of 1306.6 is entered. No lateral 
or normal reference lengths are entered for this case because the two coordinate systems differ only in 

their axial location. Up to 10 inert payload modules may be entered in the inert payloads section for 
merging. 

After the inert payloads files have been selected and referenced, the boosters will be selected. 
The first screen that the user will encounter is the "Select Booster Type" screen. The user is presented 
this screen so that the booster type may be selected. This selection prevents the user from using 
different type of boosters, hybrid and solid for example, on the same vehicle and will prevent all of the 
engines and motors in the directory from being displayed. 
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Figure A-40. Merge Module Input Menus 
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Select Booster Type 




Throttable 
Non-throttable 
Hybrids 


Select Booster files 


Select files to merge 


Files to merge 
Selected files Axial Lat 


Norm 


RSRM.SMM;1 

2983.70 237.90 

0.00 

RSRM.SMM;1 

2983.70 -237.90 

0.00 


Help 


Jp & down arrow keys to move 
nsert moves hilited file to right window 
Remove deletes hilited item in right window 
select to enter reference data 
'Jext_scrn key to toggle between window 


i 


Figure A-40. Merge Module Input Menus (Continued) 
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Figure A-40. Merge Module Input Menus ( Continued ) 
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.Select Inerts to Drop 


Name Mass 


SHROUD 7920.0 

TRANSITION STR 4358.0 
FWD STR & AVION 5501 .0 
PAYLOAD 49327.0 

LOX TANK FWD & 1889.0 

LOX TANK CYL & 1 0779.0 

LOX TANK AFT BK 4021 .0 

INTERTANK & INS 1 2493.0 
LH2 TANK FWD BK 21 07.0 
LH2 TANK CYL & 42895.0 

LH2 TANK AFT BK 2616.0 

AFT INTERSTAGE/ 4365.0 
THRUST STRUCTUR 22631.0 
STME 6 580K 55621 .0 

PROPULSION & SU 2381 6.0 


Inerts to Drop at Thrust Events 


Name 

Mass Delta Ms Evnt # 

SHROUD NOSE 

1944.0 

1944.0 

4.00 

SHROUD 

7920.0 

7920.0 

4.00 

THRUST STRUCTUR 

22631 .0 

14699.0 

2.00 

STME 6 580K 

55621 .0 

37087.0 

2.00 

PROPULSION & SU 

23816.0 

12416.0 

2.00 

BODY STRUCTURE 

28474.9 

28474.9 

2.00 

INV ENVI PROTEC 

1676.8 

1676.8 

2.00 

SEP AND RECOVER 

10369.8 

10369.8 

2.00 

PRIME POWER 

90.0 

90.0 

2.00 

ELECT AND INSTR 

1182.6 

1182.6 

2.00 

TVC SYS 

2328.0 

2328.0 

2.00 

RANGE SAFETY 

144.4 

144.4 

2.00 

FWD S CASE 

2621 1 .7 

2621 1 .7 

2.00 

FWD S INSULATIO 

4511.7 

4511.7 

2.00 

FWD S LINER 

341.8 

341.8 

2.00 

FWD S INHIBITOR 

260.0 

260.0 

2.00 


Figure A-40. Merge Module Input Menus (Concluded) 

Once the booster type is selected, the user is given the option to choose the boosters to merge 
together. All of the available booster motors or engines of the type selected will be displayed in the left 
hand window. If an old merge file has been selected, some previously selected boosters may appear in 
the right window. The user should select the boosters that will be used in the left window so that they 
appear in the right window. Also, if more than one booster module is needed, that module may be 
selected multiple times. Any modules that are mistakenly selected or any obsolete boosters that 
appear in the right window may be deleted in the right window. If no boosters are used on a vehicle, 
all of the entries should be deleted from the right screen and the Return Key pressed to leave the 
booster section. 

If all of the boosters in the right window are correct, the user should then reference the local 
booster coordinate systems to the global coordinate system. For the case shown, Figure A-40 the 
RSRM local location was at the nose of the RSRM. The nose is 2983.7 in. in the axial direction and 
237.9 in. in the lateral direction from the global system, and these directions are used as the reference 
locations. Ten booster modules may be specified for a vehicle. For the example, note that two RSRMs 
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were specified and placed on opposite sides of the vehicle by using the negative of the lateral reference 
location. 

When the booster file selection has been completed, the main engine section is presented. 
Again, the user selects what type of engines or motors to display for selection of the main engine 
modules. This option was chosen to prevent from having to display all of the engines and motors, which 
was felt to be extraneous because mixing different types of engines and motors was not thought 
practical for the main engine. 

All of the available file types that were selected will be displayed in the left window. To use 
the main engine data, the user should select the main engines from the left window so that they appear 
in the right window. Some files may initially appear in the right window if the user has selected an 
old merge file at the beginning of the sequence. If any files are mistakenly selected or any obsolete files 
are displayed, they may be deleted in the right window. When all the correct files are in the right 
window, they should be referenced to the global coordinate system. Therefore, remembering where the 
reference location of the engine or motor was selected is important. Up to 10 engines or motors may 
be placed in the right screen. For the screens shown in Figure A-40 y the 1.5 Stage Common Core was 
referenced to the tip of the vehicle nose, which is 1306.6 in. from the global coordinate system. 
Therefore, this value was entered in the axial reference location. 

Finally, once all of the inert payload, booster, and main propulsion files have been selected, 
the user is given the option to select the inert components to drop at thrust events. All of the previously 
selected files are read to extract the inert components from them. These will be displayed in the left 
window. The inerts that will be dropped should be selected, placing them in the right window. After 
all of the inerts are selected, the values should be updated in the right window. Then, the thrust event 
number, where the inert component should be dropped, and the delta mass at that thrust event should 
be used. The delta mass was used in case only part of an aggregate was dropped. For the example 
screens (see Figure A-40 ), the shroud and shroud nose, from the 1PT5STAGE.IPM module, are 
dropped at the fourth thrust event, the propulsion component structures, from the 1PT5STAGE.TEM 
module, are only partially dropped at thrust event number two, and the total mass of all the RSRM 
components, from the RSRM.SMM module, are dropped at the second thrust event. Once all of the 
inert components to be dropped are specified, the merge module sequence is complete, and the merge 
module file is calculated. 
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APPENDIX B. ROOT SUM SQUARE (RS S) PROGRAM USERS MANUAL 


The RSS Program is a post-processor program to the MASTRE Program to provide a means 
for the calculation of dispersion analysis related data. The RSS Program is a separate program and is 
initiated by the user typing the instruction "RUN RSS.MAIN”. The program is user interactive and 
requests data through a series of menus and prompts. 

The first menu displayed is the main menu, which is shown in Figure B-l. This menu allows 
the user to select from one of four selections. If the user inadvertently requests a select less than or 
equal to zero or greater than four, the message "input out of range, try again is displayed. The 
user can then select again. If the user wishes to stop, he can select the fourth option. 


********************************************* 

Select from the following menu: 

1 - Generate RSS output tables 

2 - Generate plot file of RSS and composites 

3 - Generate plot file of trajectory parameters from the dispersion file 

4 - Stop 

Kt******************************************** 

Figure B-l. RSS Main Menu 

Regardless of the option chosen (except for the fourth option), the initial selection of an option 
will prompt the user to "Input name of dispersion run file." This file is the direct-access file 
generated by the MASTRE Program (.DSP extension) and contains dispersion run data. After this 
initial prompt, the dispersion file specified will be used for all options. 

If either the first or second option is selected and is the initial selection, the root sum square 
calculations of the plus and minus dispersion data are performed and stored on the dispersion file. 
These data, along with the raw dispersion data, can then be either output as tabular data, plot data 
files, or both. 

If the first option is selected, tables in a publishable format are output. The user is first 
prompted to "Input name of output table file". The file name can contain as many as 80 characters. 
This file will contain the output tables. Figure B-2 shows the next display that defines the parameters 
available. 
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PRECEDING PAGE BLANK NOT FILMED 



1 . 

Axial accelerations (g s) 

13. 

Inertial azimuth (deg) 

2. 

Altitude (ft) 

14. 

Geodetic latitude (deg) 

3. 

Radius (ft) 

15. 

Longitude (deg) 

4. 

Relative velocity (ft/s) 

16. 

Impact latitude (deg) 

5. 

Inertial velocity (ft/s) 

17. 

Impact longitude (deg) 

6. 

Dynamic pressure (psfi) 

18. 

Vehicle weight (lb) 

7. 

Rel flight path angle (deg) 

19. 

Angle of attack (deg) 

8. 

Int flight path angle (deg) 

20. 

Sideslip angle (deg) 

9. 

Stagnation heating (BTU) 

21. 

Pitch attitude command (deg) 

10. 

Stagnation heating rate (BTU/s) 

22. 

Yaw attitude command (deg) 

11. 

Down range (ft) 

23. 

Liquid propellant consumed (lb) 

12. 

Cross range (ft) 24. Solid propellant consumed (lb) 

Figure B-2. Trajectory Parameters 


The user is then prompted "Do you wish to output all variable tables? (y/n) [n]." The 
user can either type "y", V, or press the Return Key to indicate the default (shown in brackets). If y 
is input, 24 sets of tables will be produced. If "n" is input, the user is again prompted "How many 
variables will be selected?". The user specifies a number and is prompted to "Input the number 
of the variables from above table". The "above table" refers to the parameter list shown in 
Figure B-2. The number of the selected parameters are then input. For each parameter selected, a 
set of six tables is printed. Each set consists of a positive table and a negative table for the types of 
dispersion classifications, i.e., propulsion two tables; aerodynamic/environmental; mass properties; 
guidance, navigation and control; and composites. On each table, the dispersed values of the selected 
parameter as a function of the dispersion runs are shown along with the rss of the positive dispersions 
(those having a positive sign), the rss of the negative dispersions (those having a negative sign), the 
nominal value plus the positive rss, and the nominal value minus the negative rss. No output is sent 
to the screen, and the user is returned to the main menu after the file is written. 

If the second option is selected, the user is prompted to "Input name of plot file". This plot 
file provides the nominal values, the nominal values plus the positive rss, the nominal values minus 
the negative rss, the plus composite values, and the negative composite values of selected trajectory 
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parameters. This plot is output in a format that can be used as an input to the "Cricket Graph' 
software. The display shown in Figure B-2 is presented to the user; the user is then prompted "Do 
you wish to output all variables? (y/n) [n]". The user can either type "y", "n", or press the Return 
Key to indicate the default (shown in brackets). If y" is input, all of the parameters are written to the 
plot file. If "n" is input, the user is again prompted "How many variables will be selected?". The 
user can choose from 1 to 24 variables. After inputting, the user is prompted to ’Input the number 
of the variable from above table". The "above table" refers to the parameters shown in Figure B 2 
The formats of the plot file are first a record containing character fields that identify the data followed 
by records containing the data. No output is sent to the screen, and the user is returned to the main 
menu after the file is written. 

The third option is also a plot file generator but differs from option 2 since dispersion cases 
can be output on the file for a particular requested parameter. Since this option does not output the 
rss values, the calculations of the rss values are unnecessary. The user is first prompted to "Input 
name of plot file". This is followed by the display shown in Figure B-2\ the user is then prompted 
"Select the number of one parameter from above list". The user must choose a parameter from 
the list shown in Figure B-2. Following the user selection, a display (see Figure B-3) is shown 
followed by the prompt "Do you wish to output all dispersion cases? (y/n) [n]". The user can 
either type "y\ M n", or press the Return Key to indicate the default (shown in brackets). If "y" is input, 
all of the dispersion case related data are written to the plot file. If "n" is input, the user is again 
prompted ’How many dispersion cases will be selected?". One to twenty five cases can be 
specified. The user is again prompted to define the cases to be output on the file by the prompt "Input 
the number of the dispersion cases from above table". The formats of the plot file are first a 
record containing character fields that identify the data followed by records containing the data. The 
records of the output data contain the time from lift-off, the nominal value, the plus composite value, 
the minus composite value, and the plus and minus dispersion values based on the dispersion cases. 
This plot is output in a format that can be used as an input to the "Cricket Graph" software. No output 
is sent to the screen, and the user is returned to the main menu after the file is written. 
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1 . 

STME Vacuum Thrust 

14. 

Forebody axial force 

2. 

STME Vacuum Isp 

15. 

Base force 

3. 

STME mixture ratio 

16. 

Other aerodynamic coefficients 

4. 

STME thrust misalign (pitch) 

17. 

Wind profiles (head and tail) 

5. 

STME thrust misalign (yaw) 

18. 

Wind profiles (right and left) 

6. 

ASRM web action time 

19. 

Atmospheric density 

7. 

ASRM vacuum Isp 

20. 

Core inert weights 

8. 

ASRM propellant loading 

21. 

Propulsion mod inert weights 

9. 

ASRM inert weight 

22. 

Core propellant weight 

10. 

ASRM thrust misalign (pitch) 

23. 

Center of gravity 

11. 

ASRM thrust misalign (yaw) 

24. 

Booster pitch steering 

12. 

ASRM thrust imbalance 

25. 

Booster yaw steering 

13. 

ASRM thrust uncertainty 

Figure B-3 . Dispersion Case Selection Menu 
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